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
);

Parameters

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 mit der Verwendung dieses Zertifikats fertig sind, müssen Sie diesen Zeiger an die CertFreeCertificateContext-Funktion übergeben, um die Referenzanzahl des Zertifikatkontexts zu erhöhen.

Wenn das dwFlags-Element der PCSC-Struktur nicht das CRYPTUI_SELECTCERT_MULTISELECT Flag enthält, bedeutet ein Rückgabewert von NULL , dass der Benutzer das Dialogfeld geschlossen hat, ohne ein Zertifikat auszuwählen.

Wenn das dwFlags-Element der PCSC-Struktur das CRYPTUI_SELECTCERT_MULTISELECT Flag 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 Aufrufen von CryptUIDlgSelectCertificate identisch ist, hat der Benutzer das Dialogfeld geschlossen, ohne Zertifikate auszuwählen.

Hinweise

Wenn das dwFlags-Element der CRYPTUI_SELECTCERTIFICATE_STRUCT Struktur auf CRYPTUI_SELECTCERT_LEGACY festgelegt ist, wird das Legacydialogfeld angezeigt. Andernfalls wird das aktuelle Dialogfeld für die Zertifikatauswahl angezeigt.

Requirements

Siehe auch

CRYPTUI_SELECTCERTIFICATE_STRUCT