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

Метод IX509Enrollment2::InitializeFromTemplate (certenroll.h)

  • Статья

Метод InitializeFromTemplate инициализирует объект регистрации с помощью шаблона.

Синтаксис

HRESULT InitializeFromTemplate(
  [in] X509CertificateEnrollmentContext context,
  [in] IX509EnrollmentPolicyServer      *pPolicyServer,
  [in] IX509CertificateTemplate         *pTemplate
);

Параметры

[in] context

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

Значение Значение
ContextUser
 Сертификат запрашивается для конечного пользователя.
ContextMachine
 Сертификат запрашивается для компьютера.
ContextAdministratorForceMachine
 Сертификат запрашивается администратором, действующим от имени компьютера.

[in] pPolicyServer

Указатель на объект IX509EnrollmentPolicyServer , представляющий сервер политики регистрации сертификатов (CEP), содержащий шаблон, заданный параметром pTemplate .

[in] pTemplate

Указатель на объект IX509CertificateTemplate , представляющий шаблон, используемый во время инициализации.

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

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

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

Возвращаемый код/значение Описание
E_POINTER
 Параметры pPolicyServer и pTemplate не могут иметь значение NULL.
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)
 Объект регистрации уже инициализирован.

Комментарии

Метод InitializeFromTemplate :

  • Проверяет шаблон, чтобы определить необходимый тип запроса.
  • Создает соответствующий тип объекта запроса (PKCS #10, PKCS #7 или CMC).
  • Задает следующие свойства в запросе, если значения существуют в настоящее время:
  • Инициализирует объект запроса с помощью шаблона.
  • Извлекает число подписей, политики выдачи и политики приложений из шаблона.

Требования

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

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

IX509Enrollment2