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