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

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

Синтаксис

HRESULT InitializeEncode(
  [in] IAlternativeNames *pValue
);

Параметры

[in] pValue

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

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

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

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

Замечания

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

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

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

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

Требования

См. также

IX509ExtensionAlternativeNames