struttura WINTRUST_DATA (wintrust.h)
[La struttura WINTRUST_DATA è disponibile per l'uso nei sistemi operativi specificati nella sezione Requisiti. Potrebbe essere modificato o non disponibile nelle versioni successive.]
La struttura WINTRUST_DATA viene usata quando si chiama WinVerifyTrust per passare le informazioni necessarie ai provider di attendibilità .
Sintassi
typedef struct _WINTRUST_DATA {
DWORD cbStruct;
LPVOID pPolicyCallbackData;
LPVOID pSIPClientData;
DWORD dwUIChoice;
DWORD fdwRevocationChecks;
DWORD dwUnionChoice;
union {
#if ...
WINTRUST_FILE_INFO_ *pFile;
#else
struct WINTRUST_FILE_INFO_ *pFile;
#endif
#if ...
WINTRUST_CATALOG_INFO_ *pCatalog;
#else
struct WINTRUST_CATALOG_INFO_ *pCatalog;
#endif
#if ...
WINTRUST_BLOB_INFO_ *pBlob;
#else
struct WINTRUST_BLOB_INFO_ *pBlob;
#endif
#if ...
WINTRUST_SGNR_INFO_ *pSgnr;
#else
struct WINTRUST_SGNR_INFO_ *pSgnr;
#endif
#if ...
WINTRUST_CERT_INFO_ *pCert;
#else
struct WINTRUST_CERT_INFO_ *pCert;
#endif
#if ...
WINTRUST_DETACHED_SIG_INFO_ *pDetachedSig;
#else
struct WINTRUST_DETACHED_SIG_INFO_ *pDetachedSig;
#endif
};
DWORD dwStateAction;
HANDLE hWVTStateData;
WCHAR *pwszURLReference;
DWORD dwProvFlags;
DWORD dwUIContext;
struct WINTRUST_SIGNATURE_SETTINGS_ *pSignatureSettings;
} WINTRUST_DATA, *PWINTRUST_DATA;
Membri
cbStruct
Dimensione, in byte, di questa struttura.
pPolicyCallbackData
Puntatore a un buffer di dati usato per passare dati specifici dei criteri a un provider di criteri. Questo membro può essere NULL.
pSIPClientData
Puntatore a un buffer di dati usato per passare dati specifici di (SIP) a un provider SIP. Questo membro può essere NULL.
dwUIChoice
Specifica il tipo di interfaccia utente da usare. Questo membro deve essere uno dei valori seguenti.
fdwRevocationChecks
Opzioni di controllo della revoca dei certificati. Questo membro può essere impostato per aggiungere il controllo delle revoche a quello eseguito dal provider di criteri selezionato. Questo membro deve essere uno dei valori seguenti.
| Valore | Significato |
|---|---|
|
Non verrà eseguito alcun controllo di revoca aggiuntivo quando viene usato il flag di WTD_REVOKE_NONE insieme al valore HTTPSPROV_ACTION impostato nel parametro pgActionID della funzione WinVerifyTrust. Per assicurarsi che la funzione winVerifyTrust |
|
Il controllo delle revoche verrà eseguito sull'intera catena. |
dwUnionChoice
Specifica il membro unione da utilizzare e, di conseguenza, il tipo di oggetto per il quale verrà verificata l'attendibilità. Questo membro deve essere uno dei valori seguenti.
pFile
Puntatore a una struttura WINTRUST_FILE_INFO.
pCatalog
Puntatore a una struttura WINTRUST_CATALOG_INFO.
pBlob
Puntatore a una struttura WINTRUST_BLOB_INFO.
pSgnr
Puntatore a una struttura WINTRUST_SGNR_INFO.
pCert
Puntatore a una struttura WINTRUST_CERT_INFO.
pDetachedSig
dwStateAction
Specifica l'azione da eseguire. Può trattarsi di uno dei valori seguenti.
hWVTStateData
Handle per i dati sullo stato. Il contenuto di questo membro dipende dal valore del membro dwStateAction.
pwszURLReference
Riservato per uso futuro. Impostare su NULL.
dwProvFlags
valore DWORD che specifica le impostazioni del provider di attendibilità. Può trattarsi di una combinazione bit per bit di zero o più dei valori seguenti.
| Valore | Significato |
|---|---|
|
Il trust viene verificato nello stesso modo dell'implementazione di Internet Explorer 4.0. |
|
La funzionalità della catena di Internet Explorer 4.0 non viene usata. |
|
La verifica predefinita del provider di criteri, ad esempio la firma del codice per Authenticode, non viene eseguita e si presuppone che il certificato sia valido per tutti gli utilizzi. |
|
Il controllo delle revoche non viene eseguito. |
|
Il controllo delle revoche viene eseguito solo sul certificato finale. |
|
Il controllo delle revoche viene eseguito sull'intera catena di certificati. |
|
Il controllo delle revoche viene eseguito sull'intera catena di certificati, escluso il certificato radice. |
|
Non supportato. |
|
Viene verificato solo l'hash. |
|
Viene eseguito il controllo della versione del sistema operativo predefinito. Questo flag viene usato solo per verificare i file firmati dal catalogo. |
|
Se questo flag non è impostato, tutte le firme con timestamp vengono considerate valide per sempre. L'impostazione di questo flag limita la durata valida della firma alla durata del certificato di firma. Ciò consente la scadenza delle firme con timestamp. |
|
Usare solo la cache locale per i controlli di revoca. Impedisce i controlli di revoca in rete.
Windows XP: Questo valore non è supportato. |
|
Disabilitare l'uso di algoritmi hash MD2 e MD4. Se un file è firmato tramite MD2 o MD4 e se questo flag è impostato, viene restituito un errore NTE_BAD_ALGID.
Nota Questo flag è supportato in Windows 7 con SP1 e sistemi operativi successivi.
|
|
Se questo flag viene specificato, si presuppone che il file verificato sia stato scaricato dal Web e abbia l'attributo Mark of the Web. Verranno applicati i criteri che devono essere applicati a Mark dei file Web.
Nota Questo flag è supportato nei sistemi operativi Windows 8.1 e versioni successive o nei sistemi che hanno installato KB2862966.
|
dwUIContext
Valore DWORD
| Valore | Significato |
|---|---|
|
Usare quando si chiama WinVerifyTrust per un file da eseguire. Questo è il valore predefinito. |
|
Usare quando si chiama WinVerifyTrust per un file da installare. |
pSignatureSettings
Puntatore a una struttura WINTRUST_SIGNATURE_SETTINGS.
Windows 7 con KB3033929, Windows 8 e Windows Server 2012: inizia il supporto per questo membro.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Windows XP [solo app desktop] |
| server minimo supportato | Windows Server 2003 [solo app desktop] |
| intestazione |
wintrust.h |