GetFriendlyNameOfCertW-Funktion (cryptdlg.h)

Artikel
11/20/2024

[Die GetFriendlyNameOfCert--Funktion steht für die Verwendung in den im Abschnitt "Anforderungen" angegebenen Betriebssystemen zur Verfügung. Sie kann in nachfolgenden Versionen geändert oder nicht verfügbar sein. Verwenden Sie stattdessen die CertGetNameString--Funktion mit dem CERT_NAME_FRIENDLY_DISPLAY_TYPE Flag.]

Die GetFriendlyNameOfCert--Funktion ruft den Anzeigenamen für ein Zertifikat ab.

Hinweis Diese Funktion weist keine Importbibliothek auf. Sie müssen die LoadLibrary und GetProcAddress Funktionen verwenden, um dynamisch mit CryptDlg.dllzu verknüpfen.

Syntax

CRYPTDLGAPI DWORD GetFriendlyNameOfCertW(
  [in] PCCERT_CONTEXT pccert,
       LPWSTR         pwch,
       DWORD          cwch
);

Parameter

[in] pccert

Ein Zeiger auf den Zertifikatkontext, dessen Anzeigename abgerufen wird.

pwch

Ein Zeiger auf eine Zeichenfolge, die den Anzeigenamen für das Zertifikat empfängt.

cwch

Anzahl der Zeichen, die für pwch-zugeordnet sind, einschließlich des endierenden NULL- Zeichens.

Rückgabewert

Der Rückgabewert ist die Anzahl der Zeichen, einschließlich des endenden NULL- Zeichens im zurückgegebenen Anzeigenamen.

Bemerkungen

Anmerkung

Der Header "cryptdlg.h" definiert GetFriendlyNameOfCert als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows XP [nur Desktop-Apps]
mindestens unterstützte Server-	Windows Server 2003 [Nur Desktop-Apps]
Zielplattform-	Fenster
Header-	cryptdlg.h
DLL-	CryptDlg.dll

Freigeben über