estrutura WINTRUST_DATA (wintrust.h)
[A estrutura 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 do SIP (pacote de interface de entidade ) 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 valores a seguir.
fdwRevocationChecks
Opções de marcar de revogação de certificado. Esse membro pode ser definido para adicionar verificação de revogação à feita pelo provedor de política selecionado. Esse membro deve ser um dos valores a seguir.
| Valor | Significado |
|---|---|
|
Nenhuma verificação de revogação adicional será feita quando o sinalizador 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 WinVerifyTrust não tente nenhuma recuperação de rede ao verificar assinaturas de código, WTD_CACHE_ONLY_URL_RETRIEVAL deve ser definido no parâmetro dwProvFlags . |
|
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 valores a seguir.
| Valor | Significado |
|---|---|
|
Use o arquivo apontado por pFile. |
|
Use o catálogo apontado por pCatalog. |
|
Use o BLOB apontado por pBlob. |
|
Use a estrutura [WINTRUST_SGNR_INFO](/windows/desktop/api/wintrust/ns-wintrust-wintrust_sgnr_info) apontada pelo pSgnr. |
|
Use o certificado apontado por pCert. |
pFile
Um ponteiro para uma estrutura de 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 executada. 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. Defina como NULL.
dwProvFlags
Valor 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 relação de confiança é verificada da mesma maneira que implementada pela Internet Explorer 4.0. |
|
A funcionalidade de cadeia da Internet Explorer 4.0 não é usada. |
|
A verificação padrão do provedor de política, como a 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 só é usado 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 com carimbo de data/hora 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 de NTE_BAD_ALGID será retornado.
Nota Esse sinalizador tem suporte no Windows 7 com SP1 e sistemas operacionais 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 serem aplicadas à Marca dos arquivos da Web serão impostas.
Nota Esse sinalizador tem suporte em sistemas operacionais Windows 8.1 e posteriores ou em sistemas que instalaram KB2862966.
|
dwUIContext
Um valor DWORD que especifica o contexto da interface do usuário para a função WinVerifyTrust . Isso faz com que o texto na caixa de diálogo Authenticode corresponda à ação executada no arquivo. Esse pode ser um dos valores a seguir.
| 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 WINTRUST_SIGNATURE_SETTINGS .
Windows 8 e Windows Server 2012: o suporte para este membro começa.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows XP [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2003 [somente aplicativos da área de trabalho] |
| Cabeçalho | wintrust.h |
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de