Função WintrustAddActionID (wintrust.h)

  • Artigo

[A função WintrustAddActionID está disponível para uso nos sistemas operacionais especificados na seção Requisitos. Ele poderá ser alterado ou ficar indisponível em versões subsequentes. Para verificação de certificado, use as funções CertGetCertificateChain e CertVerifyCertificateChainPolicy . Para verificação de assinatura de tecnologia do Microsoft Authenticode, use o .NET Framework.]

A função WintrustAddActionID adiciona uma ação de provedor de confiança ao sistema do usuário. Esse método deve ser chamado durante a implementação DllRegisterServer do provedor de confiança. Essa função não tem biblioteca de importação associada. Você deve usar as funções LoadLibrary e GetProcAddress para vincular dinamicamente a Wintrust.dll.

Esse método deve ser chamado apenas por um provedor de confiança.

Sintaxe

BOOL WintrustAddActionID(
  [in] GUID                    *pgActionID,
  [in] DWORD                   fdwFlags,
  [in] CRYPT_REGISTER_ACTIONID *psProvInfo
);

Parâmetros

[in] pgActionID

Um ponteiro para uma estrutura GUID que identifica a ação a ser adicionada e o provedor de confiança que dá suporte a essa ação.

O serviço WinTrust foi projetado para trabalhar com provedores de confiança implementados por terceiros. Cada provedor de confiança fornece seu próprio conjunto exclusivo de identificadores de ação. Para obter informações sobre os identificadores de ação compatíveis com um provedor de confiança, consulte a documentação desse provedor de confiança.

Por exemplo, a Microsoft fornece um Provedor de Confiança do Publicador de Software que pode estabelecer a confiabilidade do software que está sendo baixado da Internet ou de alguma outra rede pública. O Provedor de Confiança do Publicador de Software dá suporte aos seguintes identificadores de ação. Essas constantes são definidas em Softpub.h.

Valor Significado
WINTRUST_ACTION_GENERIC_VERIFY
 Verifique apenas uma cadeia de certificados.
WINTRUST_ACTION_GENERIC_VERIFY_V2
 Verifique um arquivo ou objeto usando o provedor de política Authenticode.
HTTPSPROV_ACTION
 Verifique uma conexão SSL/PCT por meio de Explorer da Internet.

[in] fdwFlags

um valor que determina se os erros do Registro são relatados por essa função. Se fdwFlags for zero e essa função apresentar um erro de registro, o erro do Registro não será propagado para a função GetLastError . Se fdwFlags for WT_ADD_ACTION_ID_RET_RESULT_FLAG (0x1) e essa função apresentar um erro de registro, o erro do Registro será propagado para a função GetLastError .

[in] psProvInfo

Um ponteiro para a estrutura CRYPT_REGISTER_ACTIONID que define as informações para o provedor de confiança.

Retornar valor

O valor retornado será TRUE se a função for bem-sucedida; FALSE se a função falhar. Se a função falhar, chame a função GetLastError para determinar o motivo da falha. Para obter informações sobre quaisquer erros de registro que essa função possa encontrar, consulte a descrição de fdwFlags.

Comentários

Para remover uma ação que foi adicionada por essa função, chame a função WintrustRemoveActionID .

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]
Plataforma de Destino Windows
Cabeçalho wintrust.h
Biblioteca Wintrust.lib
DLL Wintrust.dll

Confira também

WintrustRemoveActionID