Метод IX509ExtensionTemplate::InitializeDecode (certenroll.h)
Метод InitializeDecode инициализирует расширение из массива байтов в кодировке DER, содержащего значение расширения. Закодированный массив байтов представлен строкой в кодировке Юникод.
Синтаксис
HRESULT InitializeDecode(
[in] EncodingType Encoding,
[in] BSTR strEncodedData
);
Параметры
[in] Encoding
Значение перечисления EncodingType , указывающее тип кодировки Юникода, применяемой к параметру strEncodedData .
[in] strEncodedData
Переменная BSTR , содержащая расширение в кодировке DER.
Возвращаемое значение
Если функция завершается успешно, функция возвращает S_OK.
Если функция завершается сбоем, она возвращает значение HRESULT , указывающее на ошибку. Допустимые значения включают, но не ограничиваются, значения, приведенные в следующей таблице. Список распространенных кодов ошибок см. в разделе Общие значения HRESULT.
Возвращаемый код/значение | Описание |
---|---|
|
Объект уже инициализирован. |
Комментарии
Этот метод можно использовать, если у вас есть объект в кодировке DISTINGUISHED ENCODING RULES (DER) Abstract Syntax Notation One (ASN.1), содержащий расширение CertificateTemplate. Необходимо указать объект в кодировке DER в строке в кодировке Юникод. Дополнительные сведения см. в разделе Интерфейс IBinaryConverter .
Перед использованием объекта IX509ExtensionTemplate необходимо вызвать метод InitializeEncode или InitializeDecode. Эти два метода дополняют друг друга. Метод InitializeEncode позволяет создать объект расширения ASN.1 в кодировке DER из необработанных данных, а метод InitializeDecode позволяет инициализировать необработанные данные из закодированного объекта.
Для этого расширения можно получить следующие свойства:
- Свойство Critical определяет, является ли расширение критическим. Это свойство также можно указать.
- Свойство ObjectId извлекает идентификатор объекта (OID).
- Свойства MajorVersion и MinorVersion извлекают сведения о версии.
- Свойство TemplateOid извлекает OID шаблона.
Требования
Требование | Значение |
---|---|
Минимальная версия клиента | Windows Vista [только классические приложения] |
Минимальная версия сервера | Windows Server 2008 [только классические приложения] |
Целевая платформа | Windows |
Header | certenroll.h |
DLL | CertEnroll.dll |