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。 所选证书将包含在由 pcschSelectedCertStore 成员表示的证书存储中。 如果在调用 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