ICertRequest3 接口 (certcli.h)
ICertRequest3 接口是提供客户端或中间应用程序与证书服务之间通信的三个接口之一。
客户端和中介应用程序可以调用 ICertRequest3 方法来执行以下任务:
- 提交证书请求。
- 检索请求的处置、上次状态和标识符。
- 检索为请求颁发的证书。
- 检索先前请求的挂起证书。
- 检索证书服务服务器的 证书颁发机构 (CA) 证书。
- 检索 CA 属性值、显示名称以及与属性关联的任何标志。
- 检索服务器返回的缓存响应数据。
- 检索 HRESULT 错误代码的错误消息文本。
ICertRequest3 在 Certcli.h 中定义。 但是,在创建程序时,请使用 Certsrv.h 作为包含文件。 Certcli.dll 提供 ICertRequest3 接口。 此接口的类型信息也位于 Certcli.dll 中,该信息随平台软件开发工具包 (SDK) 一起提供。
证书服务接口同时支持单元线程和自由线程模型。 为了提高吞吐量,建议使用自由线程处理。
继承
ICertRequest3 接口继承自 ICertRequest2、ICertRequest 和 IDispatch。 ICertRequest3 还具有以下类型的成员:
方法
ICertRequest3 接口具有这些方法。
ICertRequest3::GetIssuedCertificate2 通过指定请求 ID 字符串或证书序列号来检索证书的处置。 |
ICertRequest3::GetRefreshPolicy 返回一个值,该值指示客户端的缓存证书注册策略是否过期且需要刷新。 |
ICertRequest3::GetRequestIdString 获取请求和后续证书的当前内部请求号(格式为字符串)。 |
ICertRequest3::SetCredential 设置用于联系证书注册 Web 服务的凭据。 |
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 7 [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2008 R2 [仅限桌面应用] |
目标平台 | Windows |
标头 | certcli.h (包括 Certsrv.h) |