estructura WINTRUST_DATA (wintrust.h)
[La estructura WINTRUST_DATA está disponible para su uso en los sistemas operativos especificados en la sección Requisitos. Puede modificarse o no estar disponible en versiones posteriores.]
La estructura WINTRUST_DATA se usa al llamar a winVerifyTrust para pasar información necesaria a los proveedores de confianza de .
Sintaxis
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;
Miembros
cbStruct
Tamaño, en bytes, de esta estructura.
pPolicyCallbackData
Puntero a un búfer de datos usado para pasar datos específicos de la directiva a un proveedor de directivas. Este miembro puede ser NULL.
pSIPClientData
Puntero a un búfer de datos usado para pasar paquete de interfaz de asunto (SIP) datos específicos de un proveedor SIP. Este miembro puede ser NULL.
dwUIChoice
Especifica el tipo de interfaz de usuario (UI) que se va a usar. Este miembro debe ser uno de los siguientes valores.
fdwRevocationChecks
Opciones de comprobación de revocación de certificados. Este miembro se puede establecer para agregar la comprobación de revocación a la realizada por el proveedor de directivas seleccionado. Este miembro debe ser uno de los siguientes valores.
dwUnionChoice
Especifica el miembro de unión que se va a usar y, por tanto, el tipo de objeto para el que se comprobará la confianza. Este miembro debe ser uno de los siguientes valores.
pFile
Puntero a una estructura WINTRUST_FILE_INFO.
pCatalog
Puntero a una estructura de WINTRUST_CATALOG_INFO.
pBlob
Puntero a una estructura de WINTRUST_BLOB_INFO.
pSgnr
Puntero a una estructura de WINTRUST_SGNR_INFO.
pCert
Puntero a una estructura WINTRUST_CERT_INFO.
pDetachedSig
dwStateAction
Especifica la acción que se va a realizar. Puede ser uno de los siguientes valores.
hWVTStateData
Identificador de los datos de estado. El contenido de este miembro depende del valor del miembro dwStateAction.
pwszURLReference
Reservado para uso futuro. Establezca en null.
dwProvFlags
valor DWORD que especifica la configuración del proveedor de confianza. Puede ser una combinación bit a bit de cero o más de los valores siguientes.
| Valor | Significado |
|---|---|
|
La confianza se comprueba de la misma manera que la implementada por Internet Explorer 4.0. |
|
No se usa la funcionalidad de cadena de Internet Explorer 4.0. |
|
No se realiza la comprobación predeterminada del proveedor de directivas, como la firma de código para Authenticode, y se supone que el certificado es válido para todos los usos. |
|
No se realiza la comprobación de revocación. |
|
La comprobación de revocación solo se realiza en el certificado final. |
|
La comprobación de revocación se realiza en toda la cadena de certificados. |
|
La comprobación de revocación se realiza en toda la cadena de certificados, excepto el certificado raíz. |
|
No se admite. |
|
Solo se comprueba el hash. |
|
Se realiza la comprobación de la versión predeterminada del sistema operativo. Esta marca solo se usa para comprobar los archivos firmados por el catálogo. |
|
Si no se establece esta marca, todas las firmas con marca de tiempo se consideran válidas para siempre. Establecer esta marca limita la duración válida de la firma a la vigencia del certificado de firma. Esto permite que las firmas con marca de tiempo expiren. |
|
Use solo la caché local para las comprobaciones de revocación. Impide las comprobaciones de revocación a través de la red.
Windows XP: Este valor no se admite. |
|
Deshabilite el uso de algoritmos hash MD2 y MD4. Si un archivo está firmado mediante MD2 o MD4 y si se establece esta marca, se devuelve un error de NTE_BAD_ALGID.
Nota Esta marca es compatible con Windows 7 con SP1 y sistemas operativos posteriores.
|
|
Si se especifica esta marca, se supone que el archivo que se está comprobando se ha descargado de la web y tiene la marca del atributo Web. Se aplicarán las directivas destinadas a aplicarse a Mark de los archivos web.
Nota Esta marca es compatible con windows 8.1 y sistemas operativos posteriores o en sistemas que han instalado KB2862966.
|
dwUIContext
Valor
| Valor | Significado |
|---|---|
|
Use al llamar a WinVerifyTrust para un archivo que se va a ejecutar. Este es el valor predeterminado. |
|
Use al llamar a WinVerifyTrust para un archivo que se va a instalar. |
pSignatureSettings
Puntero a una estructura de WINTRUST_SIGNATURE_SETTINGS.
Windows 7 con KB3033929, Windows 8 y Windows Server 2012: comienza la compatibilidad con este miembro.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows XP [solo aplicaciones de escritorio] |
| servidor mínimo admitido | Windows Server 2003 [solo aplicaciones de escritorio] |
| encabezado de |
wintrust.h |