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) |