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

Метод IX509EnrollmentHelper::Enroll (certenroll.h)

  • Статья

Метод Enroll регистрирует запрос сертификата и извлекает выданный сертификат. Этот метод поддерживается через Интернет.

Синтаксис

HRESULT Enroll(
  [in]          BSTR               strEnrollmentPolicyServerURI,
  [in]          BSTR               strTemplateName,
  [in]          EncodingType       Encoding,
  [in]          WebEnrollmentFlags enrollFlags,
  [out, retval] BSTR               *pstrCertificate
);

Параметры

[in] strEnrollmentPolicyServerURI

Объект BSTR, содержащий URL-адрес сервера политики регистрации сертификатов.

[in] strTemplateName

Переменная BSTR , содержащая общее имя (CN) шаблона в том виде, в котором он отображается в Active Directory, или идентификатор десятичного объекта с точками.

[in] Encoding

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

[in] enrollFlags

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

Значение Значение
EnrollPrompt
 Если этот флаг установлен и для сервера регистрации сертификатов недоступны учетные данные проверки подлинности, служба сертификатов запрашивает учетные данные. Если учетные данные для проверки подлинности отсутствуют и этот флаг не установлен, метод Enroll завершается ошибкой.

[out, retval] pstrCertificate

BSTR, содержащий выданный сертификат.

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

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

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

Код возврата Описание
E_INVALIDARG
 Параметры strEnrollmentPolicyServerURI и strTemplateName не могут иметь значение NULL.
HRESULT_FROM_WIN32(ERROR_ARITHMETIC_OVERFLOW)
 Параметры strEnrollmentPolicyServerURI и strTemplateName превышают 64 000 символов или содержат внедренные символы NULL.

Комментарии

Метод Enroll извлекает соответствующий шаблон, вызывает InitializeFromTemplate, а затем вызывает Enroll в объекте IX509Enrollment .

Этот метод не устанавливает выданный сертификат.

Требования

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

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

IX509EnrollmentHelper