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