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 |