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_STRUCT Struktur, die Informationen zum anzuzeigenden Dialogfeld enthält.
Rückgabewert
Ein Zeiger auf eine CERT_CONTEXT Struktur, die das vom Benutzer ausgewählte Zertifikat darstellt. Wenn Sie die Verwendung dieses Zertifikats abgeschlossen haben, müssen Sie diesen Zeiger an die CertFreeCertificateContext-Funktion übergeben, um die Verweisanzahl des Zertifikatkontexts zu verringern.
Wenn der dwFlags-Member der pcsc-Struktur das flag CRYPTUI_SELECTCERT_MULTISELECT nicht enthält, bedeutet der Rückgabewert NULL , dass der Benutzer das Dialogfeld geschlossen hat, ohne ein Zertifikat auszuwählen.
Wenn der dwFlags-Member der pcsc-Struktur das flag CRYPTUI_SELECTCERT_MULTISELECT enthält, gibt diese Funktion immer NULL zurück. Die ausgewählten Zertifikate sind im Zertifikatspeicher enthalten, der durch das hSelectedCertStore-Mitglied 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.
Bemerkungen
Wenn der dwFlags-Member der CRYPTUI_SELECTCERTIFICATE_STRUCT-Struktur auf CRYPTUI_SELECTCERT_LEGACY festgelegt ist, wird das Legacydialogfeld angezeigt. Andernfalls wird das Aktuelle Zertifikatauswahldialogfeld angezeigt.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows Server 2003 [nur Desktop-Apps] |
| Ende des Supports |
Windows 7 [nur Desktop-Apps] |
| Bibliothek |
|
| DLL |
|
| Unicode- und ANSI-Name |
CryptUIDlgSelectCertificateW (Unicode) und CryptUIDlgSelectCertificateA (ANSI) |