iCertRequest2 接口 (certcli.h)
ICertRequest2 接口是提供客户端或中间应用程序与证书服务之间通信的两个接口之一。
客户端和中间应用程序可以调用 ICertRequest2 方法来执行以下任务:
- 提交证书请求。
- 检索请求的处置、上次状态和标识符。
- 检索为请求颁发的证书。
- 检索先前请求的挂起证书。
- 检索证书服务服务器的 证书颁发机构 (CA) 证书。
- 检索 CA 属性值、显示名称以及与属性关联的任何标志。
- 检索服务器返回的缓存响应数据。
- 检索 HRESULT 错误代码的错误消息文本。
ICertRequest2 在 Certcli.h 中定义。 但是,在创建程序时,请使用 Certsrv.h 作为包含文件。 Certcli.dll 提供 ICertRequest2 接口。 此接口的类型信息也位于 Certclil.dll 中,该信息随平台软件开发工具包 (SDK) 一起提供。
证书服务接口支持单元线程和自由线程模型。 为了提高吞吐量,建议使用自由线程。
继承
ICertRequest2 接口继承自 ICertRequest 和 IDispatch。 ICertRequest2 还包含以下类型的成员:
方法
ICertRequest2 接口具有以下方法。
ICertRequest2::GetCAProperty 检索证书颁发机构 (CA) 的属性值。 (ICertRequest2.GetCAProperty) |
ICertRequest2::GetCAPropertyDisplayName 检索证书颁发机构的属性显示名称 (CA) 属性。 |
ICertRequest2::GetCAPropertyFlags 检索证书颁发机构 (CA) 属性的属性标志。 |
ICertRequest2::GetErrorMessageText 检索 HRESULT 错误代码的错误消息文本。 |
ICertRequest2::GetFullResponseProperty 检索服务器返回的缓存响应数据。 |
ICertRequest2::GetIssuedCertificate 通过指定请求 ID 或证书序列号来检索证书的处置。 |
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows XP [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2003 [仅限桌面应用] |
目标平台 | Windows |
标头 | certcli.h (包括 Certsrv.h) |