ICertRequest3：：GetIssuedCertificate2 方法 (certcli.h)

  • 项目

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

语法

HRESULT GetIssuedCertificate2(
  [in]          BSTR strConfig,
  [in]          BSTR strRequestId,
  [in]          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] strRequestId

一个 BSTR 值，该值表示 证书 服务数据库中的证书请求 ID。 如果要使用作为 strSerialNumber) 而不是请求 ID 传入的序列号 (，请将此参数设置为 NULL。

使用 ICertRequest3：：GetRequestIdString 方法获取请求 ID 字符串。

[in] strSerialNumber

一个 BSTR 值，该值表示 CA 颁发的证书序列号。 字符串必须将序列号指定为偶数的十六进制数字。 如有必要，可以将零作为数字的前缀，以生成偶数位数。 但是，不能使用一个以上的前导零。

strSerialNumber 值仅在 strRequestId 设置为 NULL 时使用。

[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 7 [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 R2 [仅限桌面应用]
目标平台 Windows
标头 certcli.h (包括 Certsrv.h)
Library Certidl.lib
DLL Certcli.dll

另请参阅

CCertRequest

ICertRequest3