CryptUIDlgSelectCertificateFromStore 函数 (cryptuiapi.h)

  • 项目

CryptUIDlgSelectCertificateFromStore 函数显示一个对话框，该对话框允许从指定的存储中选择证书。

语法

PCCERT_CONTEXT CryptUIDlgSelectCertificateFromStore(
  [in]           HCERTSTORE hCertStore,
  [in]           HWND       hwnd,
  [in, optional] LPCWSTR    pwszTitle,
  [in, optional] LPCWSTR    pwszDisplayString,
  [in]           DWORD      dwDontUseColumn,
  [in]           DWORD      dwFlags,
  [in]           void       *pvReserved
);

参数

[in] hCertStore

要搜索的证书存储的句柄。

[in] hwnd

显示窗口的句柄。 如果 为 NULL，则默认为桌面窗口。

[in, optional] pwszTitle

用作对话框标题的字符串。 如果 为 NULL，则使用默认标题“选择证书”。

[in, optional] pwszDisplayString

选择对话框中的文本语句。 如果 为 NULL，则使用默认短语“选择要使用的证书”。

[in] dwDontUseColumn

可以组合以排除显示的列的标志。

值 含义
CRYPTUI_SELECT_ISSUEDTO_COLUMN
 不显示 ISSUEDTO 信息。
CRYPTUI_SELECT_ISSUEDBY_COLUMN
 不显示 ISSUEDBY 信息。
CRYPTUI_SELECT_INTENDEDUSE_COLUMN
 不显示 IntendedUse 信息。
CRYPTUI_SELECT_FRIENDLYNAME_COLUMN
 不显示显示名称信息。
CRYPTUI_SELECT_LOCATION_COLUMN
 不显示位置信息。
CRYPTUI_SELECT_EXPIRATION_COLUMN
 不显示过期信息。

[in] dwFlags

当前未使用，应设置为 0。

[in] pvReserved

保留供将来使用。

返回值

返回指向所选证书上下文的指针。 如果未选择证书，则返回 NULL 。 使用完证书后，通过调用 CertFreeCertificateContext 函数释放证书上下文。

要求

要求 值
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 cryptuiapi.h
Library Cryptui.lib
DLL Cryptui.dll

另请参阅

CryptUIDlgViewContext