Função CryptRegisterOIDInfo (wincrypt.h)

Artigo
03/03/2024

A função CryptRegisterOIDInfo registra as informações de OID especificadas na estrutura CRYPT_OID_INFO , mantendo-as no registro.

Crypt32.dll contém informações predefinidas para os OIDs comumente conhecidos. Essa função permite que os aplicativos aumentem as informações de OID predefinidas. Durante a primeira chamada de CryptRegisterOIDInfo, as informações de OID registradas são instaladas.

Ao expandir as tabelas usando CryptRegisterOIDInfo, as novas entradas podem ser colocadas antes ou depois de entradas predefinidas, controladas por dwFlags. O posicionamento de informações de OID registradas afeta o resultado de CryptFindOIDInfo porque as tabelas são pesquisadas em ordem. Primeiras entradas registradas colocadas antes das entradas predefinidas serem verificadas, as entradas predefinidas são verificadas e, por fim, as entradas registradas colocadas após a verificação das entradas predefinidas. A primeira correspondência encontrada é retornada. Uma entrada recém-registrada colocada antes das entradas predefinidas pode substituir uma das entradas predefinidas.

Sintaxe

BOOL CryptRegisterOIDInfo(
  [in] PCCRYPT_OID_INFO pInfo,
  [in] DWORD            dwFlags
);

Parâmetros

[in] pInfo

Um ponteiro para uma estrutura CRYPT_OID_INFO com as informações de OID a serem registradas. Especifique o grupo para o qual as informações de OID devem ser registradas definindo o membro dwGroupId da estrutura.

Observação

Ao registrar informações de OID para algoritmos do Suite B implementados com a API de Criptografia: CNG (Próxima Geração ), você deve definir o membro Argel da estrutura CRYPT_OID_INFO como CALG_OID_INFO_CNG_ONLY (0xFFFFFFFF).

[in] dwFlags

Por padrão, as informações de OID registradas são instaladas após as entradas de OID do Crypt32.dll. Se CRYPT_INSTALL_OID_INFO_BEFORE_FLAG estiver definido, novas informações de OID serão instaladas antes das entradas do Crypt32.dll.

Retornar valor

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

Se a função falhar, o valor retornado será zero (FALSE).

Comentários

Quando terminar de usar as informações de OID, cancele o registro chamando a função CryptUnregisterOIDInfo .

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	wincrypt.h
Biblioteca	Crypt32.lib
DLL	Crypt32.dll