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 |
|
| DLL |
|
| Unicode- und ANSI-Name |
CryptUIDlgSelectCertificateW (Unicode) und CryptUIDlgSelectCertificateA (ANSI) |