estrutura WINTRUST_DATA (wintrust.h)
[A estrutura de WINTRUST_DATA está disponível para uso nos sistemas operacionais especificados na seção Requisitos. Ele pode estar alterado ou indisponível em versões subsequentes.]
A estrutura WINTRUST_DATA é usada ao chamar WinVerifyTrust para passar as informações necessárias para os provedores de confiança .
Sintaxe
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;
Membros
cbStruct
O tamanho, em bytes, dessa estrutura.
pPolicyCallbackData
Um ponteiro para um buffer de dados usado para passar dados específicos da política para um provedor de política. Esse membro pode ser NULL.
pSIPClientData
Um ponteiro para um buffer de dados usado para passar dados específicos pacote de interface do assunto (SIP) para um provedor SIP. Esse membro pode ser NULL.
dwUIChoice
Especifica o tipo de interface do usuário a ser usada. Esse membro deve ser um dos seguintes valores.
fdwRevocationChecks
Opções de verificação de revogação de certificado. Esse membro pode ser definido para adicionar verificação de revogação ao feito pelo provedor de política selecionado. Esse membro deve ser um dos seguintes valores.
| Valor | Significado |
|---|---|
|
Nenhuma verificação de revogação adicional será feita quando o sinalizador de WTD_REVOKE_NONE for usado em conjunto com o valor HTTPSPROV_ACTION definido no parâmetro pgActionID da função WinVerifyTrust. Para garantir que a função |
|
A verificação de revogação será feita em toda a cadeia. |
dwUnionChoice
Especifica o membro do sindicato a ser usado e, portanto, o tipo de objeto para o qual a confiança será verificada. Esse membro deve ser um dos seguintes valores.
pFile
Um ponteiro para uma estrutura WINTRUST_FILE_INFO.
pCatalog
Um ponteiro para uma estrutura WINTRUST_CATALOG_INFO.
pBlob
Um ponteiro para uma estrutura WINTRUST_BLOB_INFO.
pSgnr
Um ponteiro para uma estrutura WINTRUST_SGNR_INFO.
pCert
Um ponteiro para uma estrutura WINTRUST_CERT_INFO.
pDetachedSig
dwStateAction
Especifica a ação a ser tomada. Esse pode ser um dos valores a seguir.
hWVTStateData
Um identificador para os dados de estado. O conteúdo desse membro depende do valor do membro dwStateAction.
pwszURLReference
Reservado para uso futuro. Definir como NULL.
dwProvFlags
valor de DWORD que especifica as configurações do provedor de confiança. Essa pode ser uma combinação bit a bit de zero ou mais dos valores a seguir.
| Valor | Significado |
|---|---|
|
A confiança é verificada da mesma maneira que implementada pelo Internet Explorer 4.0. |
|
A funcionalidade de cadeia do Internet Explorer 4.0 não é usada. |
|
A verificação padrão do provedor de política, como assinatura de código para Authenticode, não é executada e o certificado é considerado válido para todos os usos. |
|
A verificação de revogação não é executada. |
|
A verificação de revogação é executada somente no certificado final. |
|
A verificação de revogação é executada em toda a cadeia de certificados. |
|
A verificação de revogação é executada em toda a cadeia de certificados, excluindo o certificado raiz. |
|
Não há suporte. |
|
Somente o hash é verificado. |
|
A verificação de versão do sistema operacional padrão é executada. Esse sinalizador é usado apenas para verificar arquivos assinados pelo catálogo. |
|
Se esse sinalizador não estiver definido, todas as assinaturas com carimbo de data/hora serão consideradas válidas para sempre. Definir esse sinalizador limita o tempo de vida válido da assinatura ao tempo de vida do certificado de assinatura. Isso permite que as assinaturas carimbadas expirem. |
|
Use apenas o cache local para verificações de revogação. Impede verificações de revogação pela rede.
Windows XP: Não há suporte para esse valor. |
|
Desabilite o uso de algoritmos de hash MD2 e MD4. Se um arquivo for assinado usando MD2 ou MD4 e se esse sinalizador estiver definido, um erro NTE_BAD_ALGID será retornado.
Observação Esse sinalizador tem suporte no Windows 7 com sistemas operacionais SP1 e posteriores.
|
|
Se esse sinalizador for especificado, supõe-se que o arquivo que está sendo verificado tenha sido baixado da Web e tenha a Marca do atributo Web. As políticas destinadas a se aplicar à Marca dos arquivos da Web serão impostas.
Observação Esse sinalizador tem suporte no Windows 8.1 e em sistemas operacionais posteriores ou em sistemas que instalaram KB2862966.
|
dwUIContext
Um valor
| Valor | Significado |
|---|---|
|
Use ao chamar WinVerifyTrust para um arquivo que deve ser executado. Esse é o valor padrão. |
|
Use ao chamar WinVerifyTrust para um arquivo que deve ser instalado. |
pSignatureSettings
Ponteiro para uma estrutura de WINTRUST_SIGNATURE_SETTINGS.
Windows 7 com KB3033929, Windows 8 e Windows Server 2012: começa o suporte para esse membro.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows XP [somente aplicativos da área de trabalho] |
| servidor com suporte mínimo | Windows Server 2003 [somente aplicativos da área de trabalho] |
| cabeçalho | wintrust.h |