Structure VTableProvStruc

La structure VTableProvStruc contient des pointeurs vers des fonctions de rappel qui peuvent être utilisées par les fonctions de fournisseur de services de chiffrement (CSP).

Syntaxe

typedef struct VTableProvStruc {
  DWORD   Version;
  FARPROC FuncVerifyImage;
  FARPROC FuncReturnhWnd;
  DWORD   dwProvType;
  BYTE    *pbContextInfo;
  DWORD   cbContextInfo;
  LPSTR   pszProvName;
} VTableProvStruc, *PVTableProvStruc;

Membres

Version

Valeur DWORD qui indique la version de la structure. Trois versions de cette structure sont utilisées. Les versions sont les numéros 1, 2 et 3 et déterminent quels membres de la structure sont valides. Les membres de la version 1 sont valides sur tous les systèmes qui prennent en charge cette structure.

Il s’agit d’un membre de la version 1.

FuncVerifyImage

Adresse d’une fonction de rappel FuncVerifyImage que le fournisseur de solutions Cloud utilise pour vérifier la signature des DLL que le fournisseur de services cloud va charger. Toutes les DLL auxiliaires dans lesquelles un fournisseur de services cloud effectue des appels de fonction doivent être signées de la même manière (et avec la même clé) que la DLL CSP principale. Pour garantir cette signature, les DLL auxiliaires doivent être chargées dynamiquement à l’aide de la fonction LoadLibrary . Mais avant le chargement de la DLL, la signature de la DLL doit être vérifiée. Le fournisseur de solutions Cloud effectue cette vérification en appelant la fonction FuncVerifyImage , comme illustré dans l’exemple ci-dessous.

Ce pointeur de fonction peut être stocké et utilisé jusqu’à ce que le contexte CSP soit libéré.

Il s’agit d’un membre de la version 1.

FuncReturnhWnd

Adresse d’une fonction de rappel FuncReturnhWnd qui retourne le handle de fenêtre que le fournisseur csp doit utiliser comme parent ou propriétaire de toute interface utilisateur affichée. Les fournisseurs de solutions cloud qui ne communiquent pas directement avec l’utilisateur et les fournisseurs de services cloud qui utilisent du matériel dédié à cet effet peuvent ignorer cette entrée. Ce handle de fenêtre est égal à zéro par défaut, mais une application peut lui affecter une valeur différente à l’aide de la fonction CryptSetProvParam pour définir la propriété PP_CLIENT_HWND .

Ce pointeur de fonction peut être stocké et utilisé jusqu’à ce que le contexte CSP soit libéré.

Il s’agit d’un membre de la version 1.

dwProvType

Valeur DWORD qui spécifie le type de fournisseur à acquérir. Les types de fournisseurs suivants sont prédéfinis et sont décrits en détail dans Interopérabilité csp :

• PROV_RSA_FULL
• PROV_RSA_SIG
• PROV_DSS
• PROV_FORTEZZA
• PROV_MS_EXCHANGE

Il s’agit d’un membre de la version 2.

pbContextInfo

Pointeur vers un tableau d’informations de contexte. Les membres pbContextInfo et cbContextInfo déterminent ensemble le jeu d’informations utilisé lorsqu’une fonction CPSetProvParam est appelée avec PP_CONTEXT_INFO jeu.

Il s’agit d’un membre de la version 2.

cbContextInfo

Valeur DWORD qui indique le nombre d’éléments dans le tableau pbContextInfo .

Il s’agit d’un membre de la version 2.

pszProvName

Chaîne qui contient le nom du fournisseur.

Il s’agit d’un membre de la version 3.

Notes

Les pointeurs de la structure VTableProvStruc sont uniquement disponibles dans la fonction CPAcquireContext . Si des membres de la structure sont nécessaires une fois qu’un appel à CPAcquireContext est terminé, des copies des éléments de structure nécessaires doivent être effectuées par le fournisseur de solutions Cloud. Les pointeurs de fonction dans cette structure peuvent être stockés et utilisés jusqu’à ce que le contexte CSP soit libéré.

Spécifications

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	Cspdk.h
Noms Unicode et ANSI	VTableProvStrucW (Unicode)