Platform SDK: WinTrust

WINTRUST_DATA

The WINTRUST_DATA structure is used when calling WinVerifyTrust to pass necessary information into the trust providers.

typedef struct _WINTRUST_DATA
{
    DWORD           cbStruct;
    LPVOID          pPolicyCallbackData;
    LPVOID          pSIPClientData;
    DWORD           dwUIChoice;
    DWORD           fdwRevocationChecks;
    DWORD           dwUnionChoice; 
    union
    {
        struct WINTRUST_FILE_INFO_      *pFile;
        struct WINTRUST_CATALOG_INFO_   *pCatalog;
        struct WINTRUST_BLOB_INFO_      *pBlob;
        struct WINTRUST_SGNR_INFO_      *pSgnr;
        struct WINTRUST_CERT_INFO_      *pCert;
    };
    DWORD           dwStateAction;
    HANDLE          hWVTStateData;
} WINTRUST_DATA, *PWINTRUST_DATA;

Members

cbStruct
Count of bytes in this structure.
pPolicyCallbackData
Pointer to a data buffer used to pass policy-specific data to a policy provider. This member may be NULL.
pSIPClientData
Pointer to a data buffer used to pass SIP-specific data to an SIP provider. This member may be NULL.
dwUIChoice;
Indication of the kind of user interface (UI) to be used. This member must be one of the following values.

WTD_UI_ALL
WTD_UI_NONE
WTD_UI_NOBAD
WTD_UI_NOGOOD

This is a required member.

fdwRevocationChecks;
Certificate revocation check options. Can be set to add revocation checking to be done in addition to that done by the selected policy provider. This member must be one of the following values.

WTD_REVOKE_NONE
WTD_REVOKE_WHOLECHAIN

This is a required member.

dwUnionChoice
Indication of the union member to be used and, thus, the type of object for which trust will be verified. This member must be one of the following values.

WTD_CHOICE_FILE
WTD_CHOICE_CATALOG
WTD_CHOICE_BLOB
WTD_CHOICE_SIGNER
WTD_CHOICE_CERT

This is a required member.

pFile
Pointer to a WINTRUST_FILE_INFO structure.
pCatalog
Pointer to a WINTRUST_CATALOG_INFO structure.
pBlob
Pointer to a WINTRUST_BLOB_INFO structure.
pSgnr
Pointer to a WINTRUST_SGNR_INFO structure.
pCert
Pointer to a WINTRUST_CERT_INFO structure.
dwStateAction
Currently unused. Set to zero.
hWVTStateData
Currently unused. Set to Null.

Requirements

  Windows NT/2000: Requires Windows NT 4.0 or later.
  Windows 95/98: Unsupported.
  Header: Declared in winbase.h.