GetFriendlyNameOfCertA-Funktion (cryptdlg.h)

Artikel
02/26/2024

[Die GetFriendlyNameOfCert-Funktion ist für die Verwendung in den Betriebssystemen verfügbar, die im Abschnitt Anforderungen angegeben sind. Es kann in nachfolgenden Versionen geändert oder entfernt werden. 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 verfügt über keine zugeordnete Importbibliothek. Sie müssen die Funktionen LoadLibrary und GetProcAddress verwenden, um eine dynamische Verknüpfung mit CryptDlg.dll.

Syntax

CRYPTDLGAPI DWORD GetFriendlyNameOfCertA(
  [in]  PCCERT_CONTEXT pccert,
  [out] LPSTR          pch,
  [in]  DWORD          cch
);

Parameter

[in] pccert

Ein Zeiger auf den Zertifikatkontext, dessen Anzeigename abgerufen wird.

[out] pch

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

[in] cch

Anzahl der für pchBuffer zugewiesenen Zeichen, einschließlich des beendenden NULL-Zeichens .

Rückgabewert

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

Hinweise

Hinweis

Der cryptdlg.h-Header definiert GetFriendlyNameOfCert als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code 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
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	cryptdlg.h
DLL	CryptDlg.dll

Freigeben über