ICertRequest3：：GetIssuedCertificate2 方法 (certcli.h)

  • 發行項

GetIssuedCertificate2 方法會藉由指定要求標識符字串或憑證序號來擷取憑證的處置。

語法

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 值，表示憑證服務資料庫中的憑證要求標識符。 如果要使用 strSerialNumber) 傳遞的序號 (，請將此參數設定為 NULL，而不是要求標識符。

使用 ICertRequest3：：GetRequestIdString 方法來取得要求標識符字串。

[in] strSerialNumber

BSTR 值，表示 CA 所簽發的憑證序號。 字串必須將序號指定為偶數十六進位數位。 如有必要，數位前面可以加上零，以產生偶數位數。 不過，不能使用一個以上的前置零。

只有在 strRequestId 設定為 NULL 時，才會使用 strSerialNumber 值。

[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)
程式庫 Certidl.lib
Dll Certcli.dll

另請參閱

CCertRequest

ICertRequest3