Интерфейс IX509Enrollment (certenroll.h)
Интерфейс IX509Enrollment представляет объект верхнего уровня и позволяет зарегистрироваться в иерархии сертификатов и установить ответ сертификата. Процесс регистрации поддерживает следующие три сценария:
-
Внеполосная регистрация
- Вызовите любой метод инициализации, реализованный объектом IX509Enrollment .
- Вызовите метод CreateRequest .
- Отправьте запрос из аппаратного контроллера (вручную или с помощью какого-либо другого процесса).
- Получите ответ от центра сертификации или регистрации.
- Вызовите метод InstallResponse .
- Автоматическая регистрация
- Вызовите любой метод инициализации, реализованный объектом IX509Enrollment .
- Вызовите метод Enroll .
- Отложенная регистрация
- Вызовите любой метод инициализации, реализованный объектом IX509Enrollment .
- Вызовите метод CreateRequest .
- Храните запрос в течение определенного периода времени, например дней или недель.
- Вызовите метод Initialize , чтобы создать объект запроса, когда вы будете готовы к регистрации.
- Заполните объект запроса из сохраненного запроса.
- Вызовите метод 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 |