CryptUIDlgSelectCertificate-Funktion

Die CryptUIDlgSelectCertificate-Funktion zeigt ein Dialogfeld an, in dem ein Benutzer ein Zertifikat auswählen kann.

Syntax

PCCERT_CONTEXT WINAPI CryptUIDlgSelectCertificate(
  _In_  PCCRYPTUI_SELECTCERTIFICATE_STRUCT pcsc
);

Parameter

pcsc [ In]

Ein Zeiger auf eine CRYPTUI _ SELECTCERTIFICATE-STRUKTUR, _ die Informationen über das anzuzeigende Dialogfeld enthält.

Rückgabewert

Ein Zeiger auf eine CERT _ CONTEXT-Struktur, die das vom Benutzer ausgewählte Zertifikat darstellt. Wenn Sie mit der Verwendung dieses Zertifikats fertig sind, müssen Sie diesen Zeiger an die CertFreeCertificateContext-Funktion übergeben, um den Verweiszähler des Zertifikatkontexts zu dekrementieren.

Wenn der dwFlags-Member der pcsc-Struktur das CRYPTUI _ SELECTCERT _ MULTISELECT-Flag nicht enthält, bedeutet ein Rückgabewert von NULL, dass der Benutzer das Dialogfeld geschlossen hat, ohne ein Zertifikat auszuwählen.

Wenn der dwFlags-Member der pcsc-Struktur das CRYPTUI _ SELECTCERT _ MULTISELECT-Flag enthält, gibt diese Funktion immer NULL zurück. Die ausgewählten Zertifikate werden im Zertifikatspeicher enthalten sein, der durch das hSelectedCertStore-Element von pcsc dargestellt wird. Wenn die Anzahl der Zertifikate im Speicher vor und nach dem Aufruf von CryptUIDlgSelectCertificate gleich ist, hat der Benutzer das Dialogfeld geschlossen, ohne Zertifikate auszuwählen.

Hinweise

Wenn der dwFlags-Member der CRYPTUI _ SELECTCERTIFICATE-Struktur _ auf CRYPTUI _ SELECTCERT _ LEGACY festgelegt ist, wird das Legacydialogfeld angezeigt. Andernfalls wird das aktuelle Dialogfeld für die Zertifikatauswahl angezeigt.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
nur Windows [ XP-Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows Nur Server [ 2003-Desktop-Apps]
Ende des Supports
nur Windows 7 [ Desktop-Apps]
Bibliothek
Cryptui.lib
DLL
Cryptui.dll
Unicode- und ANSI-Name
CryptUIDlgSelectCertificateW (Unicode) und CryptUIDlgSelectCertificateA (ANSI)

Weitere Informationen

CRYPTUI _ _ SELECTCERTIFICATE-STRUKTUR