Funkce CryptUIDlgSelectCertificate

Funkce CryptUIDlgSelectCertificate zobrazí dialogové okno, které uživateli umožňuje vybrat certifikát.

Syntax

PCCERT_CONTEXT WINAPI CryptUIDlgSelectCertificate(
  _In_  PCCRYPTUI_SELECTCERTIFICATE_STRUCT pcsc
);

Parametry

pcsc [in]

Ukazatel na strukturu CRYPTUI_SELECTCERTIFICATE_STRUCT obsahující informace o dialogovém okně, které se mají zobrazit.

Návratová hodnota

Ukazatel na CERT_CONTEXT strukturu, která představuje certifikát vybraný uživatelem. Po dokončení použití tohoto certifikátu musíte předat tento ukazatel na funkci CertFreeCertificateContext , aby se dekrementovaly referenční počet kontextu certifikátu.

Pokud člen dwFlags struktury pcsc neobsahuje příznak CRYPTUI_SELECTCERT_MULTISELECT , návratová hodnota NULL znamená, že uživatel zavřel dialogové okno bez výběru certifikátu.

Pokud člen dwFlags struktury pcsc obsahuje CRYPTUI_SELECTCERT_MULTISELECT příznak, tato funkce vždy vrátí hodnotu NULL. Vybrané certifikáty budou obsaženy v úložišti certifikátů reprezentované členem hSelectedCertStorepcsc. Pokud je počet certifikátů v úložišti stejný před a po volání CryptUIDlgSelectCertificate, uživatel zavřel dialogové okno bez výběru certifikátů.

Remarks

Pokud je člen dwFlags struktury CRYPTUI_SELECTCERTIFICATE_STRUCT nastaven na CRYPTUI_SELECTCERT_LEGACY, zobrazí se starší dialogové okno. V opačném případě se zobrazí dialogové okno pro výběr aktuálního certifikátu.

Požadavky

Požadavek	Value
Minimální podporovaný klient	Windows XP [pouze desktopové aplikace]
Minimální podporovaný server	Windows Server 2003 [pouze desktopové aplikace]
Ukončení podpory	Windows 7 [pouze desktopové aplikace]
Library	Cryptui.lib
knihovna DLL	Cryptui.dll
Názvy Unicode a ANSI	CryptUIDlgSelectCertificateW (Unicode) a CryptUIDlgSelectCertificateA (ANSI)

Viz také

CRYPTUI_SELECTCERTIFICATE_STRUCT