Функция CryptRegisterOIDInfo (wincrypt.h)

Статья
08/27/2023

Функция CryptRegisterOIDInfo регистрирует сведения об OID, указанные в структуре CRYPT_OID_INFO , сохраняя их в реестре.

Crypt32.dll содержит предопределенные сведения для широко известных идентификаторов OID. Эта функция позволяет приложениям дополнять предопределенные сведения об OID. Во время первого вызова CryptRegisterOIDInfo устанавливаются зарегистрированные сведения об OID.

При расширении таблиц с помощью CryptRegisterOIDInfo новые записи можно размещать до или после предопределенных записей, управляемых dwFlags. Размещение зарегистрированных сведений об идентификаторе влияет на результат CryptFindOIDInfo , так как в таблицах выполняется поиск по порядку. Сначала зарегистрированные записи, помещенные перед проверкой предопределенных записей, затем проверяются предопределенные записи и, наконец, зарегистрированные записи, размещенные после проверки предопределенных записей. Возвращается первое найденное совпадение. Недавно зарегистрированная запись, помещенная перед предопределенными записями, может переопределить одну из предопределенных записей.

Синтаксис

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

Параметры

[in] pInfo

Указатель на структуру CRYPT_OID_INFO с регистрируемой информацией об OID. Укажите группу, для которую необходимо зарегистрировать сведения об идентификаторе, задав элемент dwGroupId структуры.

Примечание

При регистрации сведений об OID для алгоритмов Набора B , реализованных с помощью API шифрования следующего поколения (CNG), необходимо задать для элемента Algidструктуры CRYPT_OID_INFOзначение CALG_OID_INFO_CNG_ONLY (0xFFFFFFFF).

[in] dwFlags

По умолчанию зарегистрированные сведения об OID устанавливаются после записи OID Crypt32.dll. Если задано CRYPT_INSTALL_OID_INFO_BEFORE_FLAG, перед записью Crypt32.dll устанавливаются новые сведения об идентификаторе идентификатора.

Возвращаемое значение

Если функция выполнена успешно, возвращаемое значение не равно нулю (TRUE).

Если функция завершается ошибкой, возвращаемое значение равно нулю (FALSE).

Требования

Требование	Значение
Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	wincrypt.h
Библиотека	Crypt32.lib
DLL	Crypt32.dll