structure CERT_CREATE_CONTEXT_PARA (wincrypt.h)

Article
08/27/2023

La structure CERT_CREATE_CONTEXT_PARA définit des valeurs supplémentaires qui peuvent être utilisées lors de l’appel de la fonction CertCreateContext .

Syntaxe

typedef struct _CERT_CREATE_CONTEXT_PARA {
  DWORD                             cbSize;
  PFN_CRYPT_FREE                    pfnFree;
  void                              *pvFree;
  PFN_CERT_CREATE_CONTEXT_SORT_FUNC pfnSort;
  void                              *pvSort;
} CERT_CREATE_CONTEXT_PARA, *PCERT_CREATE_CONTEXT_PARA;

Membres

cbSize

Taille, en octets, de cette structure.

pfnFree

Pointeur vers la fonction qui libère le paramètre pbEncoded de la fonction CertCreateContext . La fonction pfnFree est appelée lorsque le contexte créé par CertCreateContext est libéré. Cette valeur peut être NULL, auquel cas le paramètre pbEncoded de la fonction CertCreateContext n’est pas libéré.

pvFree

Adresse de la mémoire libérée par la fonction pfnFree . Si pvFree a la valeur NULL, le paramètre pbEncoded de la fonction CertCreateContext est libéré.

pfnSort

Un pointeur de fonction PFN_CERT_CREATE_CONTEXT_SORT_FUNC qui sera appelé pour chaque entrée de contexte triée.

Ce membre est uniquement présent pour un CERT_STORE_CTL_CONTEXT lorsque l’indicateur CERT_CREATE_CONTEXT_SORTED_FLAG est défini dans le paramètre dwFlags de la fonction CertCreateContext . Vous devez vérifier que ce membre est présent avant d’essayer d’y accéder en examinant le membre cbSize de cette structure.

pvSort

Valeur définie par l’application qui sera transmise dans le paramètre pvSort de la fonction de rappel PFN_CERT_CREATE_CONTEXT_SORT_FUNC .

Configuration requise


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

Voir aussi

CertCreateContext

PFN_CERT_CREATE_CONTEXT_SORT_FUNC