Метод IX509Extension::Initialize (certenroll.h)

  • Статья

Метод Initialize инициализирует объект IX509Extension, используя идентификатор объекта (OID) и массив байтов, содержащий расширение в кодировке Distinguished Encoding Rules (DER). Массив байтов в кодировке DER представлен строкой в кодировке Юникод. Этот метод поддерживается через Интернет.

Синтаксис

HRESULT Initialize(
  [in] IObjectId    *pObjectId,
  [in] EncodingType Encoding,
  [in] BSTR         strEncodedData
);

Параметры

[in] pObjectId

Указатель на интерфейс IObjectId , содержащий OID расширения.

[in] Encoding

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

[in] strEncodedData

Переменная BSTR , содержащая значение расширения в кодировке DER.

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

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

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

Возвращаемый код или значение Описание
CERTSRV_E_PROPERTY_EMPTY
 Не удалось найти идентификатор OID.

Комментарии

Расширение сертификата состоит из OID, логического значения, определяющего, является ли расширение критически важным, и массива байтов, содержащего значение расширения. Расширение определяется стандартом абстрактной синтаксической нотации 1 (ASN.1) и кодируется с помощью DER. Массив байтов в кодировке DER необходимо указать в виде строки, которая является чистой двоичной последовательностью или кодировкой Юникода. Тип кодирования, применяемый к строке, можно указать с помощью перечисления EncodingType .

Требования

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

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

IX509Extension