struttura CTL_VERIFY_USAGE_STATUS (wincrypt.h)
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 |