CRYPT_PROVIDER_DATA structure (wintrust.h)
[The CRYPT_PROVIDER_DATA structure is available for use in the operating systems specified in the Requirements section. It may be altered or unavailable in subsequent versions.]
The CRYPT_PROVIDER_DATA structure is used to pass data between WinVerifyTrust and trust providers.
Syntax
typedef struct _CRYPT_PROVIDER_DATA {
DWORD cbStruct;
WINTRUST_DATA *pWintrustData;
BOOL fOpenedFile;
HWND hWndParent;
GUID *pgActionID;
HCRYPTPROV hProv;
DWORD dwError;
DWORD dwRegSecuritySettings;
DWORD dwRegPolicySettings;
struct _CRYPT_PROVIDER_FUNCTIONS *psPfns;
DWORD cdwTrustStepErrors;
DWORD *padwTrustStepErrors;
DWORD chStores;
HCERTSTORE *pahStores;
DWORD dwEncoding;
HCRYPTMSG hMsg;
DWORD csSigners;
struct _CRYPT_PROVIDER_SGNR *pasSigners;
DWORD csProvPrivData;
struct _CRYPT_PROVIDER_PRIVDATA *pasProvPrivData;
DWORD dwSubjectChoice;
union {
#if ...
_PROVDATA_SIP *pPDSip;
#else
struct _PROVDATA_SIP *pPDSip;
#endif
};
char *pszUsageOID;
BOOL fRecallWithState;
FILETIME sftSystemTime;
char *pszCTLSignerUsageOID;
DWORD dwProvFlags;
DWORD dwFinalError;
PCERT_USAGE_MATCH pRequestUsage;
DWORD dwTrustPubSettings;
DWORD dwUIStateFlags;
struct _CRYPT_PROVIDER_SIGSTATE *pSigState;
struct WINTRUST_SIGNATURE_SETTINGS_ *pSigSettings;
} CRYPT_PROVIDER_DATA, *PCRYPT_PROVIDER_DATA;
Members
cbStruct
The size, in bytes, of this structure.
pWintrustData
A pointer to a WINTRUST_DATA structure that contains the information to verify.
fOpenedFile
A Boolean value that indicates whether the trust provider opened the file handle, if applicable.
hWndParent
A handle to the parent window. If not specified, a handle to the desktop window is used.
pgActionID
A pointer to a GUID structure that identifies an action and the trust provider that supports that action.
hProv
A handle to the cryptographic service provider (CSP). If this parameter is NULL, then the operating system will provide a default CSP.
dwError
An error level if a low-level system error was encountered.
dwRegSecuritySettings
The registry security settings.
dwRegPolicySettings
The registry policy settings.
psPfns
A pointer to a CRYPT_PROVIDER_FUNCTIONS structure.
cdwTrustStepErrors
The number of elements in the padwTrustStepErrors array.
padwTrustStepErrors
An array of DWORD values that specify trust step errors.
chStores
The number of elements in the pahStores array.
pahStores
An array of certificate store handles.
dwEncoding
A value that specifies the encoding type.
hMsg
A handle to the cryptographic message.
csSigners
The number of elements in the pasSigners array.
pasSigners
A pointer to an array of CRYPT_PROVIDER_SGNR structures.
csProvPrivData
The number of elements in the pasProvPrivData array.
pasProvPrivData
A pointer to an array of CRYPT_PROVIDER_PRIVDATA structures.
dwSubjectChoice
A value that specifies the subject choice.
pPDSip
A pointer to a _PROVDATA_SIP structure.
pszUsageOID
A pointer to a null-terminated string that contains the usage object identifier (OID).
fRecallWithState
A Boolean value that indicates whether state was maintained for catalog files.
sftSystemTime
The system time.
pszCTLSignerUsageOID
A pointer to a null-terminated string that represents the certificate trust list (CTL) signer usage OID.
dwProvFlags
A bitwise combination of one or more of the following flags.
dwFinalError
A value for the final error.
pRequestUsage
A pointer to a CERT_USAGE_MATCH structure.
dwTrustPubSettings
A value for the trust publisher settings.
dwUIStateFlags
A DWORD value that specifies state data that is passed between a trust provider and the user interface.
Windows XP with SP1 and Windows XP: This member is ignored.
pSigState
pSigSettings
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows XP [desktop apps only] |
| Minimum supported server | Windows Server 2003 [desktop apps only] |
| Header | wintrust.h |