Função CryptGetDefaultOIDFunctionAddress (wincrypt.h)

Artigo
03/03/2024

A função CryptGetDefaultOIDFunctionAddress carrega a DLL que contém um endereço de função padrão. Ele também pode retornar o endereço da primeira ou próxima função OID ( identificador de objeto padrão) instalada em um conjunto de funções inicializado e carregar a DLL que contém o endereço dessa função.

Sintaxe

BOOL CryptGetDefaultOIDFunctionAddress(
  [in]           HCRYPTOIDFUNCSET  hFuncSet,
  [in]           DWORD             dwEncodingType,
  [in, optional] LPCWSTR           pwszDll,
  [in]           DWORD             dwFlags,
  [out]          void              **ppvFuncAddr,
  [in, out]      HCRYPTOIDFUNCADDR *phFuncAddr
);

Parâmetros

[in] hFuncSet

Identificador do conjunto de funções obtido anteriormente de uma chamada para CryptInitOIDFunctionSet.

[in] dwEncodingType

Tipo de codificação a ser correspondido. Atualmente, apenas X509_ASN_ENCODING e PKCS_7_ASN_ENCODING estão sendo usados; no entanto, tipos de codificação adicionais podem ser adicionados no futuro. Para corresponder aos dois tipos de codificação atuais, use:

X509_ASN_ENCODING | PKCS_7_ASN_ENCODING

[in, optional] pwszDll

Nome da DLL a ser carregada. Normalmente, o nome da DLL é obtido da lista retornada por CryptGetDefaultOIDDllList. Se pwszDll for NULL, uma pesquisa será executada na lista de funções padrão instaladas.

[in] dwFlags

Reservado para uso futuro e deve ser zero.

[out] ppvFuncAddr

Um ponteiro para o endereço da função de retorno. Se a função falhar, um NULL será retornado em ppvFuncAddr.

[in, out] phFuncAddr

Usado somente se pwszDll for NULL. Na primeira chamada para a função , *phFuncAddr deve ser NULL para adquirir a primeira função instalada.

Quando essa função for bem-sucedida, *phFuncAddr será definido como um identificador de função. A contagem de referência para o identificador de função é incrementada.

Após a primeira chamada para a função, phFuncAddr é definido como o ponteiro retornado pela chamada anterior. Esse ponteiro de entrada é sempre liberado dentro da função por meio de uma chamada para CryptFreeOIDFunctionAddress por essa função. A chamada para liberar o ponteiro sempre é feita mesmo quando a função main retorna um erro.

Um phFuncAddr não NULL deve ser liberado por meio de uma chamada para CryptFreeOIDFunctionAddress ou ser passado de volta como entrada para essa função ou como entrada para CryptGetOIDFunctionAddress.

Se pwszDll não for NULL, o valor desse parâmetro será ignorado e um ponteiro não NULL não será liberado.

Retornar valor

Se a função for bem-sucedida, a função retornará diferente de zero (TRUE).

Se a função falhar, ela retornará zero (FALSE).

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP [aplicativos da área de trabalho \| aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2003 [aplicativos da área de trabalho \| Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	wincrypt.h
Biblioteca	Crypt32.lib
DLL	Crypt32.dll

Confira também

Funções de suporte do OID

Compartilhar via