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

Интерфейс IX509Enrollment (certenroll.h)

  • Статья

Интерфейс IX509Enrollment представляет объект верхнего уровня и позволяет зарегистрироваться в иерархии сертификатов и установить ответ сертификата. Процесс регистрации поддерживает следующие три сценария:

Внеполосная регистрация
  1. Вызовите любой метод инициализации, реализованный объектом IX509Enrollment .
  2. Вызовите метод CreateRequest .
  3. Отправьте запрос из аппаратного контроллера (вручную или с помощью какого-либо другого процесса).
  4. Получите ответ от центра сертификации или регистрации.
  5. Вызовите метод InstallResponse .
Автоматическая регистрация
  1. Вызовите любой метод инициализации, реализованный объектом IX509Enrollment .
  2. Вызовите метод Enroll .
Отложенная регистрация
  1. Вызовите любой метод инициализации, реализованный объектом IX509Enrollment .
  2. Вызовите метод CreateRequest .
  3. Храните запрос в течение определенного периода времени, например дней или недель.
  4. Вызовите метод Initialize , чтобы создать объект запроса, когда вы будете готовы к регистрации.
  5. Заполните объект запроса из сохраненного запроса.
  6. Вызовите метод InstallResponse .

Наследование

Интерфейс IX509Enrollment наследуется от интерфейса IDispatch . IX509Enrollment также имеет следующие типы членов:

Методы

Интерфейс IX509Enrollment содержит следующие методы.

 
IX509Enrollment::CreatePFX

Создает сообщение обмена личной информацией (PFX).
IX509Enrollment::CreateRequest

Извлекает закодированный запрос сертификата.
IX509Enrollment::Enroll

Кодирует запрос, отправляет его в соответствующий центр сертификации (ЦС) и устанавливает ответ.
IX509Enrollment::get_CAConfigString

Извлекает строку конфигурации, которая определяет центр сертификации (ЦС), в который был отправлен запрос на сертификат.
IX509Enrollment::get_Certificate

Извлекает установленный сертификат.
IX509Enrollment::get_CertificateDescription

Указывает или извлекает строку, содержащую описание сертификата. (Получить)
IX509Enrollment::get_CertificateFriendlyName

Указывает или извлекает отображаемое имя сертификата. (Получить)
IX509Enrollment::get_EnrollmentContext

Извлекает контекст регистрации, который определяет, предназначен ли сертификат для компьютера или конечного пользователя.
IX509Enrollment::get_NameValuePairs

Извлекает коллекцию пар "имя-значение", связанных с объектом регистрации.
IX509Enrollment::get_ParentWindow

Указывает или извлекает идентификатор окна, используемого для отображения сведений о регистрации. (Получить)
IX509Enrollment::get_Request

Извлекает запрос сертификата, связанный с объектом регистрации.
IX509Enrollment::get_RequestId

Извлекает уникальный идентификатор для запроса сертификата, отправленного в центр сертификации методом Регистрации.
IX509Enrollment::get_Response

Извлекает ответ сертификата, возвращенный центром сертификации.
IX509Enrollment::get_Silent

Указывает или извлекает логическое значение, указывающее, отображается ли пользовательский интерфейс во время регистрации сертификата. (Получить)
IX509Enrollment::get_Status

Извлекает объект IX509EnrollmentStatus, который можно использовать для мониторинга состояния процесса регистрации и получения сведений об ошибке.
IX509Enrollment::Initialize

Инициализирует объект регистрации и создает PKCS по умолчанию.
IX509Enrollment::InitializeFromRequest

Инициализирует объект регистрации из существующего объекта IX509CertificateRequest.
IX509Enrollment::InitializeFromTemplateName

Инициализирует объект регистрации из общего имени шаблона (CN).
IX509Enrollment::InstallResponse

Устанавливает цепочку сертификатов на компьютере конечной сущности. (IX509Enrollment.InstallResponse)
IX509Enrollment::p ut_CertificateDescription

Указывает или извлекает строку, содержащую описание сертификата. (Put)
IX509Enrollment::p ut_CertificateFriendlyName

Указывает или извлекает отображаемое имя сертификата. (Put)
IX509Enrollment::p ut_ParentWindow

Указывает или извлекает идентификатор окна, используемого для отображения сведений о регистрации. (Put)
IX509Enrollment::p ut_Silent

Указывает или извлекает логическое значение, указывающее, отображается ли пользовательский интерфейс во время регистрации сертификата. (Put)

Требования

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

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

API регистрации сертификатов

IDispatch

IX509EnrollmentStatus