ICertRequest2：：GetIssuedCertificate 方法 (certcli.h)

  • 發行項

GetIssuedCertificate 方法會藉由指定要求標識碼或憑證序號來擷取憑證的處置。

這個方法實際上與呼叫 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 值，表示憑證服務資料庫中的憑證要求標識符。 如果要使用 –1 作為 strSerialNumber () 傳入的序號，而不是要求標識符，請使用 –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)
程式庫 Certidl.lib
Dll Certcli.dll