CERT_STORE_PROV_INFO structure (wincrypt.h)
La structure CERT_STORE_PROV_INFO contient des informations retournées par la fonction CertDllOpenStoreProv installée lorsqu’un magasin est ouvert à l’aide du
Fonction CertOpenStore .
Lors de l’ouverture d’un magasin, la fonction CertOpenStore définit tous les champs de la structure CERT_STORE_PROV_INFO sur zéro, à l’exception de cbSize, qui est défini sur la taille de CERT_STORE_PROV_INFO. La structure est mise à jour par la fonction installable CertDllOpenStoreProv . S’il n’existe aucune fonction de rappel supplémentaire à appeler, cStoreProvFunc reste zéro au retour.
Syntaxe
typedef struct _CERT_STORE_PROV_INFO {
DWORD cbSize;
DWORD cStoreProvFunc;
void **rgpvStoreProvFunc;
HCERTSTOREPROV hStoreProv;
DWORD dwStoreProvFlags;
HCRYPTOIDFUNCADDR hStoreProvFuncAddr2;
} CERT_STORE_PROV_INFO, *PCERT_STORE_PROV_INFO;
Membres
cbSize
Contient la taille, en octets, de cette structure.
cStoreProvFunc
Contient le nombre d’éléments dans le tableau rgpvStoreProvFunc . Ce nombre doit inclure toutes les valeurs NULL utilisées dans les index avant la dernière fonction de rappel implémentée. Par exemple, si une seule fonction de rappel est implémentée, mais qu’elle se trouve à l’index 2 (CERT_STORE_PROV_WRITE_CERT_FUNC), avec NULL pour les index 0 et 1, le nombre 3 doit être passé pour ce paramètre.
rgpvStoreProvFunc
Tableau de pointeurs vers les fonctions de rappel implémentées par le fournisseur. Ce tableau est indexé par les valeurs fournies dans le tableau suivant, et elles doivent être dans l’ordre indiqué. La fonction de rappel associée s’affiche également. Toutes les fonctions de rappel qui ne sont pas implémentées doivent avoir la valeur NULL. Le tableau n’a pas besoin de contenir tous les index de fonction de rappel, il doit uniquement contenir l’index de fonction de rappel le plus élevé implémenté. Par exemple, si seule la fonction de rappel CERT_STORE_PROV_WRITE_CERT_FUNC (2) est implémentée, le tableau ne doit contenir que trois éléments.
hStoreProv
Valeur 32 bits définie par l’application qui est le premier paramètre passé à tous les rappels. Une application peut spécifier le contenu de ce membre comme vous le souhaitez. En règle générale, il s’agit d’un pointeur vers des données spécifiques à l’application, telles que les informations d’état du fournisseur pour chaque magasin ouvert.
dwStoreProvFlags
Contient un ensemble d’indicateurs qui spécifient le fonctionnement du fournisseur. Contient zéro ou une combinaison d’une ou plusieurs des valeurs suivantes.
| Valeur | Signification |
|---|---|
|
Le fournisseur stocke les certificats, les listes de révocation decertificats et les listes d’approbation de certificats externes au cache du magasin. |
|
Le magasin a été supprimé avec succès. Le rappel CertStoreProvCloseCallback n’est pas appelé. |
|
Par défaut, le fournisseur conserve les modifications apportées au magasin. Si cet indicateur est défini, le fournisseur ne conserve pas les modifications apportées au magasin. |
|
Le fournisseur conserve les contextes dans une banque système. |
|
Le fournisseur conserve les contextes dans un magasin système LocalMachine. |
hStoreProvFuncAddr2
Contient le handle retourné par CryptGetOIDFunctionAddress. CertCloseStore appelle CryptFreeOIDFunctionAddress pour libérer un hStoreProvFuncAddr2 non null. Cela permet au rappel d’appeler une autre fonction installable qui sera libérée à la fermeture du magasin.
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 | wincrypt.h |