Compartilhar via


Função WintrustGetDefaultForUsage (wintrust.h)

A função WintrustGetDefaultForUsage recupera o identificador de uso padrão e as informações de retorno de chamada.

Sintaxe

BOOL WintrustGetDefaultForUsage(
  [in]      DWORD                   dwAction,
  [in]      const char              *pszUsageOID,
  [in, out] CRYPT_PROVIDER_DEFUSAGE *psUsage
);

Parâmetros

[in] dwAction

Ação a ser executada. Esse pode ser um dos valores a seguir. Para obter mais informações, consulte Comentários.

Valor Significado
DWACTION_ALLOCANDFILL
Aloque memória e preencha a estrutura CRYPT_PROVIDER_DEFUSAGE apontada pelo parâmetro psUsage .
DWACTION_FREE
Libere toda a memória alocada durante uma chamada anterior para essa função especificando DWACTION_ALLOCANDFILL para esse parâmetro.

[in] pszUsageOID

Ponteiro para uma cadeia de caracteres que contém o identificador.

[in, out] psUsage

Ponteiro para uma estrutura CRYPT_PROVIDER_DEFUSAGE que contém informações de retorno de chamada a serem recuperadas.

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.

Comentários

Chame essa função uma vez com o parâmetro dwAction definido como DWACTION_ALLOCANDFILL para alocar memória e preencher uma estrutura CRYPT_PROVIDER_DEFUSAGE com informações. Chame essa função novamente com o parâmetro dwAction definido como DWACTION_FREE para liberar a memória alocada.

As informações padrão de uso e retorno de chamada para um provedor são registradas chamando a função WintrustAddDefaultForUsage .

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

CRYPT_PROVIDER_DEFUSAGE

CRYPT_PROVIDER_REGDEFUSAGE

WintrustAddDefaultForUsage