CryptUIDlgSelectCertificate függvény

A CryptUIDlgSelectCertificate függvény egy párbeszédpanelt jelenít meg, amely lehetővé teszi a felhasználó számára a tanúsítvány kiválasztását.

Szemantika

PCCERT_CONTEXT WINAPI CryptUIDlgSelectCertificate(
  _In_  PCCRYPTUI_SELECTCERTIFICATE_STRUCT pcsc
);

Paraméterek

pcsc [in]

Mutató egy CRYPTUI_SELECTCERTIFICATE_STRUCT struktúrára, amely a megjelenítendő párbeszédpanelre vonatkozó információkat tartalmazza.

Visszaadott érték

Mutató egy CERT_CONTEXT struktúrára, amely a felhasználó által kiválasztott tanúsítványt jelöli. Ha befejezte a tanúsítvány használatát, ezt a mutatót át kell adnia a CertFreeCertificateContext függvénynek a tanúsítványkörnyezet hivatkozási számának csökkenéséhez.

Ha a pcsc-struktúradwFlags tagja nem tartalmazza a CRYPTUI_SELECTCERT_MULTISELECT jelzőt, a NULL visszatérési érték azt jelenti, hogy a felhasználó tanúsítvány kiválasztása nélkül bezárta a párbeszédpanelt.

Ha a pcsc-struktúradwFlags tagja tartalmazza a CRYPTUI_SELECTCERT_MULTISELECT jelzőt, ez a függvény mindig NULL értéket ad vissza. A kijelölt tanúsítványok a pcschSelectedCertStore-tag által képviselt tanúsítványtárolóban lesznek tárolva. Ha az áruházban lévő tanúsítványok száma megegyezik a CryptUIDlgSelectCertificate hívása előtt és után, a felhasználó tanúsítvány kiválasztása nélkül bezárta a párbeszédpanelt.

Megjegyzések

Ha a CRYPTUI_SELECTCERTIFICATE_STRUCT struktúra dwFlags tagja CRYPTUI_SELECTCERT_LEGACY van beállítva, megjelenik az örökölt párbeszédpanel. Ellenkező esetben megjelenik az aktuális tanúsítványkijelölési párbeszédpanel.

Követelmények

Követelmény	Érték
Minimálisan támogatott ügyfél	Windows XP [csak asztali alkalmazások]
Minimálisan támogatott kiszolgáló	Windows Server 2003 [csak asztali alkalmazások]
A támogatás vége	Windows 7 [csak asztali alkalmazások]
Library	Cryptui.lib
DLL	Cryptui.dll
Unicode- és ANSI-nevek	CryptUIDlgSelectCertificateW (Unicode) és CryptUIDlgSelectCertificateA (ANSI)

Lásd még

CRYPTUI_SELECTCERTIFICATE_STRUCT