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

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

Синтаксис

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

Параметры

[in] strQualifier

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

[in] Type

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

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

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

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

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

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

Замечания

При указании PolicyQualifierTypeUrl в параметре Type этот метод связывает строку, введенную в параметр strQualifier , с XCN_OID_PKIX_POLICY_QUALIFIER_CPS (1.3.6.1.5.5.7.2.1 ) и кодирует его с помощью правил различаемой кодировки (DER). URL-адрес закодирован как строка IA5 абстрактного синтаксиса (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 [только классические приложения]
целевая платформа Виндоус
Header certenroll.h
DLL CertEnroll.dll

См. также

IPolicyQualifier

  • Last updated on