Función CryptRegisterOIDInfo (wincrypt.h)

Artículo
08/27/2023

La función CryptRegisterOIDInfo registra la información de OID especificada en la estructura de CRYPT_OID_INFO y la conserva en el registro.

Crypt32.dll contiene información predefinida para los OID conocidos habitualmente. Esta función permite a las aplicaciones aumentar la información de OID predefinida. Durante la primera llamada de CryptRegisterOIDInfo, se instala la información del OID registrado.

Al expandir las tablas mediante CryptRegisterOIDInfo, las nuevas entradas se pueden colocar antes o después de las entradas predefinidas, controladas por dwFlags. La ubicación de la información de OID registrada afecta al resultado de CryptFindOIDInfo porque las tablas se buscan en orden. Primero se comprueban las entradas registradas antes de comprobar las entradas predefinidas, luego se comprueban las entradas predefinidas y, por último, las entradas registradas colocadas después de comprobar las entradas predefinidas. Se devuelve la primera coincidencia encontrada. Una entrada recién registrada colocada antes de que las entradas predefinidas puedan invalidar una de las entradas predefinidas.

Sintaxis

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

Parámetros

[in] pInfo

Puntero a una estructura de CRYPT_OID_INFO con la información de OID que se va a registrar. Especifique el grupo para el que se va a registrar la información del OID estableciendo el miembro dwGroupId de la estructura.

Nota

Al registrar información de OID para algoritmos de Suite B implementados con Cryptography API: Next Generation (CNG), debe establecer el miembro Algid de la estructura de CRYPT_OID_INFOen CALG_OID_INFO_CNG_ONLY (0xFFFFFFFF).

[in] dwFlags

De forma predeterminada, la información de OID registrada se instala después de las entradas de OID de Crypt32.dll. Si se establece CRYPT_INSTALL_OID_INFO_BEFORE_FLAG, se instala la nueva información de OID antes de las entradas de Crypt32.dll.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es distinto de cero (TRUE).

Si se produce un error en la función, el valor devuelto es cero (FALSE).

Comentarios

Cuando haya terminado de usar la información de OID, anule el registro llamando a la función CryptUnregisterOIDInfo .

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	wincrypt.h
Library	Crypt32.lib
Archivo DLL	Crypt32.dll