CryptUIDlgSelectCertificate 函數

CryptUIDlgSelectCertificate 函式會顯示一個對話框，讓使用者選擇憑證。

語法

PCCERT_CONTEXT WINAPI CryptUIDlgSelectCertificate(
  _In_  PCCRYPTUI_SELECTCERTIFICATE_STRUCT pcsc
);

Parameters

PCSC [印第安納]

指向包含對話框資訊的 CRYPTUI_SELECTCERTIFICATE_STRUCT 結構指標。

返回值

指向代表使用者所選憑證的 CERT_CONTEXT 結構的指標。 使用完此憑證後，必須將此指標傳給 CertFreeCertificateContext 函式，以減少憑證上下文的參考數量。

如果 pcsc 結構中的 dwFlags 成員不包含 CRYPTUI_SELECTCERT_MULTISELECT 標誌，回傳值為 NULL 表示使用者關閉對話框時未選擇憑證。

如果 pcsc 結構中的 dwFlags 成員確實包含 CRYPTUI_SELECTCERT_MULTISELECT 標誌，這個函式總是回傳 NULL。 所選憑證將存放於由 psc hSelectedCertStore 會員代表的憑證庫中。 如果在呼叫 CryptUIDlgSelectCertificate 前後，儲存庫中的憑證數量相同，使用者會關閉對話框，未選擇任何憑證。

備註

如果 CRYPTUI_SELECTCERTIFICATE_STRUCT 結構中的 dwFlags 成員設為 CRYPTUI_SELECTCERT_LEGACY，則會顯示舊有對話框。 否則，會顯示目前的憑證選擇對話框。

要求

參見

CRYPTUI_SELECTCERTIFICATE_STRUCT