CryptUIDlgSelectCertificate 函式
CryptUIDlgSelectCertificate函式會顯示一個對話方塊,可讓使用者選取憑證。
語法
PCCERT_CONTEXT WINAPI CryptUIDlgSelectCertificate(
_In_ PCCRYPTUI_SELECTCERTIFICATE_STRUCT pcsc
);
參數
-
pcsc [in]
-
CRYPTUI_SELECTCERTIFICATE_STRUCT結構的指標,其中包含要顯示之對話方塊的相關資訊。
傳回值
CERT_CONTEXT結構的指標,代表使用者選取的憑證。 當您完成使用此憑證時,必須將此指標傳遞至 CertFreeCertificateCoNtext 函式,以遞減憑證內容的參考計數。
如果pcsc結構的dwFlags成員不包含CRYPTUI_SELECTCERT_MULTISELECT旗標,則傳回值為Null表示使用者關閉對話方塊而不選取憑證。
如果pcsc結構的dwFlags成員包含CRYPTUI_SELECTCERT_MULTISELECT旗標,此函式一律會傳回Null。 選取的憑證會包含在pcsc的 hSelectedCertStore成員所代表的憑證存放區中。 如果存放區中的憑證數目在呼叫 CryptUIDlgSelectCertificate之前和之後相同,使用者就會關閉對話方塊,而不選取任何憑證。
備註
如果CRYPTUI_SELECTCERTIFICATE_STRUCT結構的dwFlags成員設定為CRYPTUI_SELECTCERT_LEGACY,則會顯示舊版對話方塊。 否則會顯示目前的憑證選取對話方塊。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 |
Windows XP [僅限傳統型應用程式] |
最低支援的伺服器 |
Windows Server 2003 [僅限傳統型應用程式] |
結束支援 |
Windows 7 [僅限傳統型應用程式] |
程式庫 |
|
DLL |
|
Unicode 與 ANSI 名稱 |
CryptUIDlgSelectCertificateW (Unicode) 和 CryptUIDlgSelectCertificateA (ANSI) |