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

CryptUIDlgViewSignerInfo