Интерфейс ICertRequest (certcli.h)
Интерфейс ICertRequest обеспечивает обмен данными между клиентским или промежуточным приложением и службами сертификатов.
Клиентские и промежуточные приложения могут вызывать методы ICertRequest для выполнения следующих задач:
- Отправьте запрос на сертификат.
- Получите сведения о ликвидации, последнем состоянии и идентификаторе запроса.
- Получите сертификат, выданный для запроса.
- Получение ожидающих сертификатов для предыдущих запросов.
- Получите сертификат центра сертификации (ЦС) для сервера служб сертификации.
ICertRequest определяется в Certcli.h. Однако при создании программы используйте Certsrv.h в качестве включаемого файла. Certcli.dll предоставляет интерфейс ICertRequest . Сведения о типе этого интерфейса также содержатся в Certclil.dll, который поставляется вместе с пакетом средств разработки платформенного программного обеспечения (SDK).
Интерфейсы служб сертификатов поддерживают как модели потоков с подразделениями, так и с бесплатными потоками. Для повышения пропускной способности рекомендуется использовать свободные потоки.
Наследование
Интерфейс ICertRequest наследуется от интерфейса IDispatch . ICertRequest также имеет следующие типы членов:
Методы
Интерфейс ICertRequest содержит следующие методы.
ICertRequest::GetCACertificate Возвращает сертификат центра сертификации (ЦС) для сервера служб сертификации. |
ICertRequest::GetCertificate Возвращает сертификат, выданный для запроса как сертификат X.509 или при необходимости упакованный в стандарты шифрования с открытым ключом (PKCS) |
ICertRequest::GetDispositionMessage Возвращает удобочитаемое сообщение, которое предоставляет текущее состояние ликвидации запроса на сертификат. |
ICertRequest::GetLastStatus Возвращает последний код возврата для этого запроса. При этом возвращаются сведения о коде ошибки, а не о ликвидации запроса. |
ICertRequest::GetRequestId Возвращает текущий номер внутреннего запроса для запроса и последующего сертификата. |
ICertRequest::RetrievePending Извлекает состояние ликвидации сертификата из предыдущего запроса, который ранее возвращал CR_DISP_INCOMPLETE или CR_DISP_UNDER_SUBMISSION. |
ICertRequest::Submit Отправляет запрос на сервер служб сертификатов. |
Требования
Требование | Значение |
---|---|
Минимальная версия клиента | Windows XP [только классические приложения] |
Минимальная версия сервера | Windows Server 2003 [только классические приложения] |
Целевая платформа | Windows |
Header | certcli.h (включая Certsrv.h) |