CTL_VERIFY_USAGE_STATUS structure (wincrypt.h)

La structure CTL_VERIFY_USAGE_STATUS contient des informations sur une liste de certificats d’approbation (CTL) retournée par CertVerifyCTLUsage.

Syntaxe

typedef struct _CTL_VERIFY_USAGE_STATUS {
  DWORD          cbSize;
  DWORD          dwError;
  DWORD          dwFlags;
  PCCTL_CONTEXT  *ppCtl;
  DWORD          dwCtlEntryIndex;
  PCCERT_CONTEXT *ppSigner;
  DWORD          dwSignerIndex;
} CTL_VERIFY_USAGE_STATUS, *PCTL_VERIFY_USAGE_STATUS;

Membres

cbSize

Taille de la structure en octets. L’application appelant CertVerifyCTLUsage définit ce paramètre. Si cbSize n’est pas supérieur ou égal à la taille requise de la structure, CertVerifyCTLUsage retourne FALSE et GetLastError retourne E_INVALIDARG.

dwError

L’erreur status, le cas échéant, retournée par l’appel à CertVerifyCTLUsage. Pour obtenir la liste des valeurs d’erreur possibles, consultez la section Valeurs de retour dans CertVerifyCTLUsage.

dwFlags

Si CERT_VERIFY_UPDATED_CTL_FLAG est retourné, CertVerifyCTLUsage a mis à jour une CTL dont l’heure n’était plus valide avec une nouvelle CTL valide dans le temps.

ppCtl

Pointeur vers un pointeur vers un contexte CTL contenant l’objet mis en correspondance. L’application appelante peut définir ce pointeur sur NULL pour indiquer qu’une CTL contenant l’objet ne doit pas être retournée.

Si ppCtl n’est pas NULL, l’application appelante doit libérer le contexte retourné à l’aide de CertFreeCTLContext.

dwCtlEntryIndex

Retourne l’emplacement du tableau de l’entrée de l’objet correspondant dans le tableau de la CTL.

ppSigner

Pointeur vers un pointeur vers le contexte de certificat du signataire de la CTL. Ce pointeur peut être défini sur NULL par l’application appelante indiquant que le certificat du signataire de la CTL ne doit pas être retourné.

Si ppSigner n’est pas NULL, l’application appelante doit libérer le contexte retourné à l’aide de CertFreeCTLContext.

dwSignerIndex

Index du signataire réellement utilisé. Nécessaire si un message a plusieurs signataires.

Remarques

Les membres dwError, dwFlags, dwCtlEntryIndex et dwSignerIndex doivent être initialisés à zéro par l’application appelante.

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

Voir aussi

CERT_CONTEXT

CTL_CONTEXT

CertVerifyCTLUsage