ICertRequest 接口 (certcli.h)

ICertRequest 接口提供客户端或中间应用程序与证书服务之间的通信。

客户端和中间应用程序可以调用 ICertRequest 方法来执行以下任务:

  • 提交证书请求。
  • 检索请求的处置、上次状态和标识符。
  • 检索为请求颁发的证书。
  • 检索先前请求的挂起证书。
  • 检索证书服务服务器的 证书颁发机构 (CA) 证书。

ICertRequest 在 Certcli.h 中定义。 但是,在创建程序时,请使用 Certsrv.h 作为包含文件。 Certcli.dll 提供 ICertRequest 接口。 此接口的类型信息也位于 Certclil.dll 中,该信息随平台软件开发工具包 (SDK) 一起提供。

证书服务接口同时支持单元线程和自由线程模型。 为了提高吞吐量,建议使用自由线程处理。

继承

ICertRequest 接口继承自 IDispatch 接口。 ICertRequest 还具有以下类型的成员:

方法

ICertRequest 接口具有这些方法。

 
ICertRequest::GetCACertificate

返回证书服务服务器的证书颁发机构 (CA) 证书。
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
标头 certcli.h (包括 Certsrv.h)