共用方式為


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 [僅限傳統型應用程式]
程式庫
Cryptui.lib
DLL
Cryptui.dll
Unicode 與 ANSI 名稱
CryptUIDlgSelectCertificateW (Unicode) 和 CryptUIDlgSelectCertificateA (ANSI)

另請參閱

CRYPTUI_SELECTCERTIFICATE_STRUCT