Função CryptInstallOIDFunctionAddress (wincrypt.h)

Artigo
03/13/2024

A função CryptInstallOIDFunctionAddress instala um conjunto de endereços de função OID ( identificador de objeto callable).

Sintaxe

BOOL CryptInstallOIDFunctionAddress(
  [in] HMODULE                       hModule,
  [in] DWORD                         dwEncodingType,
  [in] LPCSTR                        pszFuncName,
  [in] DWORD                         cFuncEntry,
  [in] const CRYPT_OID_FUNC_ENTRY [] rgFuncEntry,
  [in] DWORD                         dwFlags
);

Parâmetros

[in] hModule

Esse parâmetro é atualizado com o parâmetro hModule passado para DllMain para impedir que a DLL que contém os endereços de função seja descarregada por CryptGetOIDFunctionAddress ou CryptFreeOIDFunctionAddress. Esse seria o caso quando a DLL também registrou funções OID por meio de CryptRegisterOIDFunction.

[in] dwEncodingType

Especifica o 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] pszFuncName

Nome do conjunto de funções que está sendo instalado.

[in] cFuncEntry

Número de elementos de matriz em rgFuncEntry[].

[in] rgFuncEntry

Matriz de estruturas CRYPT_OID_FUNC_ENTRY , cada uma contendo um OID e o endereço inicial de sua rotina correlacionada.

As funções padrão são instaladas definindo o membro pszOID da estrutura CRYPT_OID_FUNC_ENTRY para que seu elemento de matriz CRYPT_DEFAULT_OID.

[in] dwFlags

Por padrão, um novo conjunto de funções é instalado no final da lista de conjuntos de funções. Definir o sinalizador CRYPT_INSTALL_OID_FUNC_BEFORE_FLAG instala o conjunto de funções no início da lista.

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

CRYPT_OID_FUNC_ENTRY

Funções de suporte do OID

Compartilhar via