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 [仅限桌面应用] |
库 |
|
DLL |
|
Unicode 和 ANSI 名称 |
CryptUIDlgSelectCertificateW (Unicode) 和 CryptUIDlgSelectCertificateA (ANSI) |