struttura CTL_VERIFY_USAGE_STATUS (wincrypt.h)

  • Articolo

La struttura CTL_VERIFY_USAGE_STATUS contiene informazioni su un elenco certificati attendibili (CTL) restituito da CertVerifyCTLUsage.

Sintassi

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;

Members

cbSize

Dimensione, in byte, della struttura. L'applicazione che chiama CertVerifyCTLUsage imposta questo parametro. Se cbSize non è maggiore o uguale alle dimensioni necessarie della struttura, CertVerifyCTLUsage restituisce FALSE e GetLastError restituisce E_INVALIDARG.

dwError

Stato dell'errore, se presente, restituito dalla chiamata a CertVerifyCTLUsage. Per l'elenco dei possibili valori di errore, vedere la sezione Valori restituiti in CertVerifyCTLUsage.

dwFlags

Se viene restituito CERT_VERIFY_UPDATED_CTL_FLAG, CertVerifyCTLUsage ha aggiornato un elenco CTL il cui tempo non è più valido con una nuova durata CTL valida per il tempo.

ppCtl

Puntatore a un puntatore a un contesto CTL contenente l'oggetto corrispondente. L'applicazione chiamante può impostare questo puntatore su NULL per indicare che non deve essere restituito un CTL contenente l'oggetto.

Se ppCtl non è NULL, l'applicazione chiamante deve liberare il contesto restituito usando CertFreeCTLContext.

dwCtlEntryIndex

Restituisce la posizione della matrice della voce dell'oggetto corrispondente nella matrice del CTL.

ppSigner

Puntatore a un puntatore al contesto del certificato del firmatario del CTL. Questo puntatore può essere impostato su NULL dall'applicazione chiamante che indica che il certificato del firmatario del CTL non deve essere restituito.

Se ppSigner non è NULL, l'applicazione chiamante deve liberare il contesto restituito usando CertFreeCTLContext.

dwSignerIndex

Indice del firmatario effettivamente usato. Necessario se un messaggio ha più di un firmatario.

Commenti

I membri dwError, dwFlags, dwCtlEntryIndex e dwSignerIndex devono essere inizializzati su zero dall'applicazione chiamante.

Requisiti

Requisito Valore
Client minimo supportato Windows XP [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Intestazione wincrypt.h

Vedi anche

CERT_CONTEXT

CTL_CONTEXT

CertVerifyCTLUsage