CRYPTUI_VIEWSIGNERINFO_STRUCT structure
[The CRYPTUI_VIEWSIGNERINFO_STRUCT structure is available for use in the operating systems specified in the Requirements section. It may be altered or unavailable in subsequent versions.]
The CRYPTUI_VIEWSIGNERINFO_STRUCT structure contains information for the CryptUIDlgViewSignerInfo function.
Note
This structure is not declared in a published header file. To use this structure, declare it in the exact format shown.
Syntax
typedef struct tagCRYPTUI_VIEWSIGNERINFO_STRUCT {
DWORD dwSize;
HWND hwndParent;
DWORD dwFlags;
LPCTSTR szTitle;
CMSG_SIGNER_INFO *pSignerInfo;
HCRYPTMSG hMsg;
LPCSTR pszOID;
DWORD_PTR dwReserved;
DWORD cStores;
HCERTSTORE *rghStores;
DWORD cPropSheetPages;
LPCPROPSHEETPAGE rgPropSheetPages;
} CRYPTUI_VIEWSIGNERINFO_STRUCT, *PCRYPTUI_VIEWSIGNERINFO_STRUCT;
Members
-
dwSize
-
The size, in bytes, of this structure.
-
hwndParent
-
The handle of the window to be the parent of the dialog box. This member can be NULL if the dialog box should have no parent.
-
dwFlags
-
A set of flags that modifies the behavior of the CryptUIDlgViewSignerInfo function. There are no flags currently defined, so this member must be zero.
-
szTitle
-
A pointer to a null-terminated string that contains the title to be displayed in the dialog box. If this member is NULL, a default title is used.
-
pSignerInfo
-
A pointer to a CMSG_SIGNER_INFO structure that contains the signer information to display.
-
hMsg
-
The handle of the message that the signer information was extracted from.
-
pszOID
-
A pointer to a null-terminated ANSI string that contains the string representation of the object identifier (OID) that signifies what the certificate that did the signing should be validated for. For example, if this is being called to view the signature of a certificate trust list (CTL), the szOID_KP_CTL_USAGE_SIGNING OID string should be passed in. If this member is NULL, the certificate is not validated for usages.
-
dwReserved
-
This parameter is not currently used. This member must be NULL.
-
cStores
-
The number of elements in the rghStores array.
-
rghStores
-
An array of HCERTSTORE values that represent the other certificate stores to search for the certificate that signed the message. If this member is NULL, no additional stores are searched. The cStores member contains the number of elements in this array.
-
cPropSheetPages
-
The number of elements in the rgPropSheetPages array.
-
rgPropSheetPages
-
An array of PROPSHEETPAGE structure pointers that define any extra pages to display in the standard dialog box. If this member is NULL, no additional pages will be displayed. The cPropSheetPages member contains the number of elements in this array.
Requirements
Requirement | Value |
---|---|
Minimum supported client |
Windows XP [desktop apps only] |
Minimum supported server |
Windows Server 2003 [desktop apps only] |
Unicode and ANSI names |
CRYPTUI_VIEWSIGNERINFO_STRUCTW (Unicode) and CRYPTUI_VIEWSIGNERINFO_STRUCTA (ANSI) |
See also