CryptUIDlgSelectCertificateFromStore-Funktion (cryptuiapi.h)

Die CryptUIDlgSelectCertificateFromStore-Funktion zeigt ein Dialogfeld an, das die Auswahl eines Zertifikats aus einem angegebenen Speicher zulässt.

Syntax

PCCERT_CONTEXT CryptUIDlgSelectCertificateFromStore(
  [in]           HCERTSTORE hCertStore,
  [in]           HWND       hwnd,
  [in, optional] LPCWSTR    pwszTitle,
  [in, optional] LPCWSTR    pwszDisplayString,
  [in]           DWORD      dwDontUseColumn,
  [in]           DWORD      dwFlags,
  [in]           void       *pvReserved
);

Parameter

[in] hCertStore

Handle des zu durchsuchenden Zertifikatspeichers.

[in] hwnd

Handle des Fensters für die Anzeige. Bei NULL wird standardmäßig das Desktopfenster verwendet.

[in, optional] pwszTitle

Zeichenfolge, die als Titel des Dialogfelds verwendet wird. Bei NULL wird der Standardtitel "Zertifikat auswählen" verwendet.

[in, optional] pwszDisplayString

Text-Anweisung im Auswahldialogfeld. Bei NULL wird der Standardausdruck "Wählen Sie ein Zertifikat aus, das Sie verwenden möchten" verwendet.

[in] dwDontUseColumn

Flags, die kombiniert werden können, um Spalten von der Anzeige auszuschließen.

Wert Bedeutung
CRYPTUI_SELECT_ISSUEDTO_COLUMN
Zeigen Sie die ISSUEDTO-Informationen nicht an.
CRYPTUI_SELECT_ISSUEDBY_COLUMN
Zeigen Sie die ISSUEDBY-Informationen nicht an.
CRYPTUI_SELECT_INTENDEDUSE_COLUMN
Zeigen Sie keine Informationen zu "IntendedUse" an.
CRYPTUI_SELECT_FRIENDLYNAME_COLUMN
Zeigen Sie die Anzeigenameninformationen nicht an.
CRYPTUI_SELECT_LOCATION_COLUMN
Zeigen Sie keine Standortinformationen an.
CRYPTUI_SELECT_EXPIRATION_COLUMN
Zeigen Sie keine Ablaufinformationen an.

[in] dwFlags

Derzeit nicht verwendet und sollte auf 0 festgelegt werden.

[in] pvReserved

Für die zukünftige Verwendung reserviert.

Rückgabewert

Gibt einen Zeiger auf den ausgewählten Zertifikatkontext zurück. Wenn kein Zertifikat ausgewählt wurde, wird NULL zurückgegeben. Wenn Sie die Verwendung des Zertifikats abgeschlossen haben, geben Sie den Zertifikatkontext frei, indem Sie die CertFreeCertificateContext-Funktion aufrufen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile cryptuiapi.h
Bibliothek Cryptui.lib
DLL Cryptui.dll

Weitere Informationen

CryptUIDlgViewContext