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

Siehe auch

CRYPTUI_SELECTCERTIFICATE_STRUCT