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

Метод InitializeEncode инициализирует расширение из массива байтов, содержащего идентификатор ключа. Массив байтов представлен строкой в кодировке Юникода.

Синтаксис

HRESULT InitializeEncode(
  [in] EncodingType Encoding,
  [in] BSTR         strKeyIdentifier
);

Параметры

[in] Encoding

Значение перечисления EncodingType , указывающее тип кодировки Юникода, примененный к параметру strKeyIdentifier .

[in] strKeyIdentifier

Переменная BSTR , содержащая идентификатор ключа.

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

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

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

Замечания

Как правило, входное значение должно быть хэшом SHA-1 открытого ключа , содержащегося в сертификате подписи центра сертификации. Метод связывает значение с идентификатором объекта XCN_OID_SUBJECT_KEY_IDENTIFIER (2.5.29.14) и кодирует его с помощью различающихся правил кодирования (DER).

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

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

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

Требования

См. также

IX509ExtensionSubjectKeyIdentifier