Compartilhar via


Função CryptFreeOIDFunctionAddress (wincrypt.h)

A função CryptFreeOIDFunctionAddress libera um identificador retornado por CryptGetOIDFunctionAddress ou CryptGetDefaultOIDFunctionAddress diminuindo a contagem de referência no identificador de função. Em alguns casos, o arquivo DLL associado à função é descarregado. Para obter detalhes, consulte Observações.

Sintaxe

BOOL CryptFreeOIDFunctionAddress(
  [in] HCRYPTOIDFUNCADDR hFuncAddr,
  [in] DWORD             dwFlags
);

Parâmetros

[in] hFuncAddr

Identificador da função obtida anteriormente de uma chamada para CryptGetOIDFunctionAddress ou CryptGetDefaultOIDFunctionAddress.

[in] dwFlags

Reservado para uso futuro e deve ser zero.

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).

Comentários

Se a contagem de referência se tornar zero e uma DLL for carregada para a função que está sendo liberada, a DLL poderá ser descarregada. Se a DLL exportar a função DLLCanUnloadNow , essa função será chamada e seu retorno será verificado. Um retorno S_FALSE dessa função cancela o descarregamento da DLL no momento. Se a função retornar S_TRUE ou se a DLL não exportar a função DLLCanUnloadNow , um processo de descarregamento será iniciado. Nesse caso, o descarregamento real é adiado por 15 segundos. Se outro CryptFreeOIDFunctionAddress ou CryptGetDefaultOIDFunctionAddress que requer a DLL ocorrer antes do decorrido de 15 segundos, o processo de descarregamento adiado será cancelado.

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

CryptGetDefaultOIDFunctionAddress

CryptGetOIDFunctionAddress

Dllcanunloadnow

Funções de suporte do OID