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