CryptUIDlgSelectCertificate 函数

CryptUIDlgSelectCertificate 函数显示一个对话框，允许用户选择证书。

Syntax

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，则会显示旧对话框。 否则，将显示当前证书选择对话框。

Requirements

另见

CRYPTUI_SELECTCERTIFICATE_STRUCT