Интерфейс ICertRequest3 (certcli.h)
Интерфейс ICertRequest3 является одним из трех интерфейсов, которые обеспечивают обмен данными между клиентом или промежуточным приложением и службами сертификатов.
Клиентские и промежуточные приложения могут вызывать методы ICertRequest3 для выполнения следующих задач:
- Отправьте запрос на сертификат.
- Получение сведений о ликвидации, последнем состоянии и идентификаторе запроса.
- Получите сертификат, выданный для запроса.
- Получение ожидающих сертификатов для предыдущих запросов.
- Получите сертификат центра сертификации (ЦС) для сервера служб сертификатов.
- Получите значение свойства ЦС, отображаемое имя и все флаги, связанные со свойством .
- Получение кэшированных данных ответа, возвращенных сервером.
- Получение текста сообщения об ошибке для кода ошибки HRESULT .
ICertRequest3 определен в Certcli.h. Однако при создании программы используйте Certsrv.h в качестве включаемого файла. Certcli.dll предоставляет интерфейс ICertRequest3 . Сведения о типе этого интерфейса также содержатся в Certcli.dll, который поставляется вместе с пакетом средств разработки программного обеспечения платформы (SDK).
Интерфейсы служб сертификатов поддерживают как модели потоковых, так и бесплатных потоков. Для повышения пропускной способности рекомендуется использовать свободные потоки.
Наследование
Интерфейс ICertRequest3 наследуется от ICertRequest2, ICertRequest и IDispatch. ICertRequest3 также имеет следующие типы элементов:
Методы
Интерфейс ICertRequest3 содержит следующие методы.
| ICertRequest3::GetIssuedCertificate2 Извлекает сведения о ликвидации сертификата, указывая строку идентификатора запроса или серийный номер сертификата. |
| ICertRequest3::GetRefreshPolicy Возвращает значение, указывающее, устарела ли политика регистрации кэшированных сертификатов клиента и нуждается в обновлении. |
| ICertRequest3::GetRequestIdString Возвращает текущий номер внутреннего запроса в формате строки для запроса и последующего сертификата. |
| ICertRequest3::SetCredential Задает учетные данные, используемые для связи с веб-службой регистрации сертификатов. |
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 7 [только классические приложения] |
| Минимальная версия сервера | Windows Server 2008 R2 [только классические приложения] |
| Целевая платформа | Windows |
| Header | certcli.h (включая Certsrv.h) |