ICertRequest2：：GetIssuedCertificate 方法 (certcli.h)

  • 项目

GetIssuedCertificate 方法通过指定请求 ID 或证书序列号来检索证书的处置。

此方法实际上与调用 ICertRequest3：：RetrievePending 相同，具有为相关证书指定序列号的额外功能。

语法

HRESULT GetIssuedCertificate(
  [in]          const BSTR strConfig,
  [in]          LONG       RequestId,
  [in]          const BSTR strSerialNumber,
  [out, retval] LONG       *pDisposition
);

参数

[in] strConfig

表示证书服务服务器的有效配置字符串。 字符串可以是注册服务器的 HTTPS URL，也可以采用 ComputerName\CAName 格式，其中 ComputerName 是服务器的网络名称， CAName 是 证书颁发机构的公用名称，如证书服务设置过程中输入的那样。 有关配置字符串名称的信息，请参阅 ICertConfig。

Windows Server 2008、Windows Vista、Windows Server 2003 和 Windows XP： 不支持将 HTTPS URL 作为输入。

[in] RequestId

一个 LONG 值，表示证书服务数据库中的 证书请求 ID。 如果要使用作为 strSerialNumber) 传递的序列号 (而不是请求 ID，则对此值使用 –1。

[in] strSerialNumber

一个 BSTR 值，该值表示 CA 颁发的证书序列号。 若要使用 strSerialNumber ，必须为 RequestId 指定值 –1。

[out, retval] pDisposition

指向表示证书处置的 LONG 值的指针。 处置是以下值之一。

值 含义
CR_DISP_DENIED
 请求被拒绝。
CR_DISP_ERROR
 请求失败。
CR_DISP_INCOMPLETE
 请求未完成。
CR_DISP_ISSUED
 证书已颁发。
CR_DISP_ISSUED_OUT_OF_BAND
 单独颁发的证书。
CR_DISP_UNDER_SUBMISSION
 在提交下进行的请求。

返回值

C++

如果该方法成功，该方法将返回S_OK。

如果方法失败，它将返回指示错误的 HRESULT 值。 有关常见错误代码的列表，请参阅 常见 HRESULT 值。

VB

返回值为 Long ，表示证书的处置。

要求

要求 值
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 certcli.h (包括 Certsrv.h)
Library Certidl.lib
DLL Certcli.dll