structure CRYPT_PROVIDER_DATA (wintrust.h)

[La structure CRYPT_PROVIDER_DATA est disponible pour une utilisation dans les systèmes d’exploitation spécifiés dans la section Configuration requise. Il peut être modifié ou indisponible dans les versions suivantes.]

La structure CRYPT_PROVIDER_DATA est utilisée pour transmettre des données entre WinVerifyTrust et des fournisseurs d’approbation.

Syntaxe

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;

Membres

cbStruct

Taille, en octets, de cette structure.

pWintrustData

Pointeur vers une structure de WINTRUST_DATA qui contient les informations à vérifier.

fOpenedFile

Valeur booléenne qui indique si le fournisseur d’approbation a ouvert le handle de fichier, le cas échéant.

hWndParent

Handle de la fenêtre parente. S’il n’est pas spécifié, un handle de la fenêtre de bureau est utilisé.

pgActionID

Pointeur vers une structure GUID qui identifie une action et le fournisseur d’approbation qui prend en charge cette action.

hProv

Handle du fournisseur de services de chiffrement (CSP). Si ce paramètre a la valeur NULL, le système d’exploitation fournit un fournisseur de solutions cloud par défaut.

dwError

Niveau d’erreur si une erreur système de bas niveau a été rencontrée.

dwRegSecuritySettings

Paramètres de sécurité du Registre.

dwRegPolicySettings

Paramètres de stratégie du Registre.

psPfns

Pointeur vers une structure CRYPT_PROVIDER_FUNCTIONS .

cdwTrustStepErrors

Nombre d’éléments dans le tableau padwTrustStepErrors .

padwTrustStepErrors

Tableau de valeurs DWORD qui spécifient des erreurs d’étape d’approbation.

chStores

Nombre d’éléments dans le tableau pahStores .

pahStores

Tableau de handles de magasin de certificats.

dwEncoding

Valeur qui spécifie le type d’encodage.

hMsg

Handle du message de chiffrement.

csSigners

Nombre d’éléments dans le tableau pasSigners .

pasSigners

Pointeur vers un tableau de structures CRYPT_PROVIDER_SGNR .

csProvPrivData

Nombre d’éléments dans le tableau pasProvPrivData .

pasProvPrivData

Pointeur vers un tableau de structures CRYPT_PROVIDER_PRIVDATA .

dwSubjectChoice

Valeur qui spécifie le choix du sujet.

pPDSip

Pointeur vers une structure _PROVDATA_SIP .

pszUsageOID

Pointeur vers une chaîne terminée par null qui contient l’identificateur d’objet d’utilisation (OID).

fRecallWithState

Valeur booléenne qui indique si l’état a été conservé pour les fichiers catalogue.

sftSystemTime

Heure système.

pszCTLSignerUsageOID

Pointeur vers une chaîne terminée par null qui représente l’OID d’utilisation de la liste d’approbation de certificats (CTL) du signataire.

dwProvFlags

Combinaison au niveau du bit d’un ou plusieurs des indicateurs suivants.

Valeur	Signification
CPD_USE_NT5_CHAIN_FLAG 0x80000000	Utilisez le chaînage Windows 2000.
CPD_REVOCATION_CHECK_NONE 0x00010000	Aucune vérification de révocation n’est effectuée.
CPD_REVOCATION_CHECK_END_CERT 0x00020000	La vérification de révocation du certificat de fin est effectuée.
CPD_REVOCATION_CHECK_CHAIN 0x00040000	La vérification de la révocation de la chaîne de certificats est effectuée.
CPD_REVOCATION_CHECK_CHAIN_EXCLUDE_ROOT 0x00080000	La vérification de révocation de la chaîne de certificats, à l’exclusion du certificat racine, est effectuée.

dwFinalError

Valeur de l’erreur finale.

pRequestUsage

Pointeur vers une structure CERT_USAGE_MATCH .

dwTrustPubSettings

Valeur pour les paramètres de l’éditeur d’approbation.

dwUIStateFlags

Valeur DWORD qui spécifie les données d’état passées entre un fournisseur d’approbation et l’interface utilisateur.

Windows XP avec SP1 et Windows XP : Ce membre est ignoré.

pSigState

pSigSettings

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
En-tête	wintrust.h