CRYPTUI_SELECTCERTIFICATE_STRUCT 结构

  • 项目

CRYPTUI_SELECTCERTIFICATE_STRUCT 结构包含有关 CryptUIDlgSelectCertificate 函数显示的对话框的信息。

语法

typedef struct _CRYPTUI_SELECTCERTIFICATE_STRUCT {
  DWORD               dwSize;
  HWND                hwndParent;
  DWORD               dwFlags;
  LPCTSTR             szTitle;
  DWORD               dwDontUseColumn;
  LPCTSTR             szDisplayString;
  PFNCFILTERPROC      pFilterCallback;
  PFNCCERTDISPLAYPROC pDisplayCallback;
  void                *pvCallbackData;
  DWORD               cDisplayStores;
  HCERTSTORE          *rghDisplayStores;
  DWORD               cStores;
  HCERTSTORE          *rghStores;
  DWORD               cPropSheetPages;
  LPCPROPSHEETPAGE    rgPropSheetPages;
  HCERTSTORE          hSelectedCertStore;
} CRYPTUI_SELECTCERTIFICATE_STRUCT, *PCRYPTUI_SELECTCERTIFICATE_STRUCT;

成员

dwSize

此结构的大小（以字节为单位）。

hwndParent

对话框的父窗口的句柄。 如果此值为 NULL，则父窗口为默认桌面窗口。

dwFlags

指定 CryptUIDlgSelectCertificate 函数的其他选项。 这可以是零，也可以是以下值的按位 OR 。

值 含义
CRYPTUI_SELECTCERT_ADDFROMDS
 保留。
CRYPTUI_SELECTCERT_LEGACY
 指定显示旧对话框。
CRYPTUI_SELECTCERT_MULTISELECT
 允许用户在对话框中选择多个证书。 如果设置了此标志， CryptUIDlgSelectCertificate 函数始终返回 NULL。 此结构的 hSelectedCertStore 成员必须包含证书存储的句柄。 用户选择的证书将添加到此存储区。
CRYPTUI_SELECTCERT_PUT_WINDOW_TOPMOST
 强制加密 UI 成为屏幕上的顶部窗口。

 

szTitle

对话框的显示标题。 如果此成员的值为 NULL，则使用默认标题“选择证书”。

dwDontUseColumn

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

值 含义
CRYPTUI_SELECT_ISSUEDTO_COLUMN
1 (0x1)
不显示 ISSUEDTO 信息。
CRYPTUI_SELECT_ISSUEDBY_COLUMN
2 (0x2)
不显示 ISSUEDBY 信息。
CRYPTUI_SELECT_INTENDEDUSE_COLUMN
4 (0x4)
不显示 IntendedUse 信息。
CRYPTUI_SELECT_FRIENDLYNAME_COLUMN
8 (0x8)
不显示名称信息。
CRYPTUI_SELECT_LOCATION_COLUMN
16 (0x10)
不显示位置信息。
CRYPTUI_SELECT_EXPIRATION_COLUMN
32 (0x20)
不显示过期信息。

 

szDisplayString

对话框中显示用于指示用户的文本。 如果此成员的值为 NULL，则使用默认字符串“选择要使用的证书”。

pFilterCallback

指向 PFNCFILTERPROC 回调函数的指针，该函数筛选对话框中显示的证书。

pDisplayCallback

指向 PFNCCERTDISPLAYPROC 回调函数的指针，该函数显示用户选择要查看的证书。

pvCallbackData

传递给 pFilterCallback 和 pDisplayCallback 成员指定的回调函数的其他数据。

cDisplayStores

rghDisplayStores 数组中的证书存储数。

rghDisplayStores

指向存储数组的指针，这些存储区包含可在对话框中选择的证书。

cStores

rghStores 数组中的证书存储数。

rghStores

指向证书存储数组的指针，用于在生成证书链和验证对话框中显示的证书的信任时进行搜索。

cPropSheetPages

rgPropSheetPages 数组中的属性页数。

rgPropSheetPages

指向 PROPSHEETPAGE 结构数组的指针，这些结构表示在选择证书进行查看时传递给证书查看对话框的属性页。

hSelectedCertStore

调用方创建的证书存储的句柄。 用户选择的证书将添加到此存储区。 如果在调用 CryptUIDlgSelectCertificate 之前和之后此存储中的证书数相同，则用户关闭了对话框而不选择任何证书。

如果此结构的 dwFlags 成员不包含 CRYPTUI_SELECTCERT_MULTISELECT 标志，则不使用此成员。

要求

要求 值
最低受支持的客户端
 Windows XP [仅限桌面应用]
最低受支持的服务器
 Windows Server 2003 [仅限桌面应用]
Unicode 和 ANSI 名称
 CRYPTUI_SELECTCERTIFICATE_STRUCTW (unicode) 和 CRYPTUI_SELECTCERTIFICATE_STRUCTA (ANSI)

另请参阅

CryptUIDlgSelectCertificate