Метод IObjectId::InitializeFromName (certenroll.h)

Статья
08/22/2023

Метод InitializeFromName инициализирует объект из значения перечисления CERTENROLL_OBJECTID . Этот метод включен через Интернет.

Синтаксис

HRESULT InitializeFromName(
  [in] CERTENROLL_OBJECTID Name
);

Параметры

[in] Name

Значение перечисления CERTENROLL_OBJECTID .

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

Если функция завершается успешно, функция возвращает S_OK.

Если функция завершается сбоем, она возвращает значение HRESULT , указывающее на ошибку. Допустимые значения включают, но не ограничиваются, значения, приведенные в следующей таблице. Список распространенных кодов ошибок см. в разделе Общие значения HRESULT.

Возвращаемый код/значение	Описание
CERTSRV_E_PROPERTY_EMPTY	Не удалось найти сведения об идентификаторе идентификатора.
CRYPT_E_UNKNOWN_ALGO	Имя алгоритма не распознано.
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)	Объект уже инициализирован.

Каждое значение CERTENROLL_OBJECTID связано с идентификатором объекта ASN.1. Например, значение XCN_OID_ECDSA_SHA1 связано со строкой, содержащей 1.2.840.10045.4.1. Это точечное десятичное представление идентификатора объекта iso(1)member-body(2)us(840)10045 signatures(4)sha1(1).

Метод InitializeFromName ищет в реестре сведения, связанные с идентификатором объекта ASN.1. При обнаружении сведений метод внутренне заполняет структуру CRYPT_OID_INFO и связывает ее с объектом . Метод также использует локальные сведения для инициализации, если это возможно, отображаемого имени объекта.

Для получения сведений об инициализированном объекте IObjectId можно вызвать следующие свойства:

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Целевая платформа	Windows
Header	certenroll.h
DLL	CertEnroll.dll

См. также раздел

FriendlyName

IObjectID

Поделиться через