Интерфейс 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)