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

Статья
08/22/2023

Метод InitializeEncode инициализирует объект из строки и значения, определяющего тип квалификатора.

Синтаксис

HRESULT InitializeEncode(
  [in] BSTR                strQualifier,
  [in] PolicyQualifierType Type
);

Параметры

[in] strQualifier

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

[in] Type

Значение перечисления PolicyQualifierType , указывающее тип квалификатора, примененного к политике сертификатов. Это может быть одно из следующих значений.

Значение	Значение
PolicyQualifierTypeUnknown	Тип квалификатора не указан.
PolicyQualifierTypeUrl	Квалификатор — это URL-адрес, указывающий на заявление о практике сертификации (CPS), которое было определено центром сертификации для определения политик, в соответствии с которым был выдан сертификат, и целей, для которых можно использовать сертификат.
PolicyQualifierTypeUserNotice	Квалификатор — это текстовая инструкция, отображаемая приложением для любого пользователя, который использует сертификат. В уведомлении пользователя указывается разрешенное использование сертификата.

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

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

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

Код возврата	Описание
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)	Объект уже инициализирован.

Если указать PolicyQualifierTypeUrl в параметре Type, этот метод связывает строку, введенную в параметре strQualifier, с идентификатором объекта (OID) XCN_OID_PKIX_POLICY_QUALIFIER_CPS (1.3.6.1.5.5.7.2.1) и кодирует ее с помощью Distinguished Encoding Rules (DER). URL-адрес закодирован как строка IA5 Abstract Syntax Notation One (ASN.1).

Если указать PolicyQualifierTypeUserNotice в параметре Type , этот метод связывает строку, введенную в параметре strQualifier , с XCN_OID_PKIX_POLICY_QUALIFIER_USERNOTICE (1.3.6.1.5.5.7.2.2) и кодирует ее с помощью DER.

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

Свойство ObjectId извлекает идентификатор OID, который определяет, является ли квалификатор cps или уведомлением пользователя.
Свойство Qualifier извлекает строку, указанную для параметра strQualifier метода InitializeEncode .
Свойство RawData извлекает квалификатор в кодировке DER.
Свойство Type извлекает значение перечисления PolicyQualifierType , указывающее тип квалификатора.

Требования

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

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

IPolicyQualifier

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