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

Метод IX509ExtensionAlternativeNames::InitializeEncode (certenroll.h)

  • Статья

Метод InitializeEncode инициализирует расширение из коллекции IAlternativeNames .

Синтаксис

HRESULT InitializeEncode(
  [in] IAlternativeNames *pValue
);

Параметры

[in] pValue

Указатель на интерфейс IAlternativeNames .

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

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

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

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

Комментарии

Метод связывает коллекцию имен с идентификатором объекта (OID) XCN_OID_SUBJECT_ALT_NAME2 (2.5.29.17) и кодирует его с помощью Distinguished Encoding Rules (DER).

Перед использованием объекта IX509ExtensionAlternativeNames необходимо вызвать Метод InitializeEncode или InitializeDecode. Эти два метода дополняют друг друга. Метод InitializeEncode позволяет создать объект расширения Abstract Syntax Notation One (ASN.1) в кодировке DER из необработанных данных, а метод InitializeDecode позволяет инициализировать необработанные данные из закодированного объекта.

Для этого расширения можно получить следующие свойства:

  • Свойство Critical определяет, является ли расширение критическим. Это свойство также можно указать.
  • Свойство ObjectId извлекает OID.
  • Свойство AlternativeNames извлекает коллекцию имен (необработанные данные расширения).

Требования

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

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

IX509ExtensionAlternativeNames