CryptUIDlgSelectCertificate işlevi

CryptUIDlgSelectCertificate işlevi, kullanıcının sertifika seçmesine izin veren bir iletişim kutusu görüntüler.

Sözdizimi

PCCERT_CONTEXT WINAPI CryptUIDlgSelectCertificate(
  _In_  PCCRYPTUI_SELECTCERTIFICATE_STRUCT pcsc
);

Parametreler

pcsc [in]

Görüntülenecek iletişim kutusu hakkında bilgi içeren bir CRYPTUI_SELECTCERTIFICATE_STRUCT yapısının işaretçisi.

Dönüş değeri

Kullanıcı tarafından seçilen sertifikayı temsil eden bir CERT_CONTEXT yapısının işaretçisi. Bu sertifikayı kullanmayı bitirdiğinizde, sertifika bağlamının başvuru sayısını azaltması için bu işaretçiyi CertFreeCertificateContext işlevine geçirmeniz gerekir.

pcsc yapısının dwFlags üyesi CRYPTUI_SELECTCERT_MULTISELECT bayrağı içermiyorsa, NULL dönüş değeri kullanıcının bir sertifika seçmeden iletişim kutusunu kapattığını gösterir.

pcsc yapısının dwFlags üyesi CRYPTUI_SELECTCERT_MULTISELECT bayrağı içeriyorsa, bu işlev her zaman NULL döndürür. Seçilen sertifikalar, pcsc'ninhSelectedCertStore üyesi tarafından temsil edilen sertifika deposunda yer alır. Depodaki sertifika sayısı CryptUIDlgSelectCertificate çağrılmadan önce ve sonra aynıysa, kullanıcı herhangi bir sertifika seçmeden iletişim kutusunu kapattı.

Açıklamalar

CRYPTUI_SELECTCERTIFICATE_STRUCT yapısının dwFlags üyesi CRYPTUI_SELECTCERT_LEGACY olarak ayarlanırsa, eski iletişim kutusu görüntülenir. Aksi takdirde, geçerli sertifika seçimi iletişim kutusu görüntülenir.

Requirements

Gereksinim	Değer
Desteklenen en düşük düzeydeki istemci	Windows XP [yalnızca masaüstü uygulamaları]
Desteklenen en düşük sunucu	Windows Server 2003 [yalnızca masaüstü uygulamaları]
Destek sonu	Windows 7 [yalnızca masaüstü uygulamaları]
Library	Cryptui.lib
DLL	Cryptui.dll
Unicode ve ANSI adları	CryptUIDlgSelectCertificateW (Unicode) ve CryptUIDlgSelectCertificateA (ANSI)

Ayrıca bakınız

CRYPTUI_SELECTCERTIFICATE_STRUCT