CertSelectCertificateA-Funktion (cryptdlg.h)

Die CertSelectCertificate-Funktion zeigt ein Dialogfeld an, in dem der Benutzer Zertifikate aus einer Gruppe von Zertifikaten auswählen kann, die den angegebenen Kriterien entsprechen.

Hinweis Diese Funktion verfügt über keine zugeordnete Importbibliothek. Sie müssen die Funktionen LoadLibrary und GetProcAddress verwenden, um dynamisch mit CryptDlg.dll zu verknüpfen.

 

Syntax

CRYPTDLGAPI BOOL CertSelectCertificateA(
  [in, out] PCERT_SELECT_STRUCT_A pCertSelectInfo
);

Parameter

[in, out] pCertSelectInfo

Ein Zeiger auf eine CERT_SELECT_STRUCT Struktur, die Kriterien enthält, die die angezeigten Zertifikate für die Auswahl steuern und das ausgewählte Zertifikat empfängt.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert TRUE.

Wenn die Funktion fehlschlägt, ist der Rückgabewert FALSE. Rufen Sie die GetLastError-Funktion auf, um erweiterte Fehlerinformationen zu erhalten.

Hinweise

Hinweis

Der cryptdlg.h-Header definiert CertSelectCertificate 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
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

Weitere Informationen

CERT_SELECT_STRUCT