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

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

  • Статья

Метод 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