ICertRequest 介面 (certcli.h)

ICertRequest 介面提供用戶端或中繼應用程式與憑證服務之間的通訊。

用戶端與中繼應用程式可以呼叫 ICertRequest 方法來執行下列工作:

  • 提交憑證要求。
  • 擷取要求的處置、最後一個狀態和標識碼。
  • 擷取針對要求發出的憑證。
  • 擷取先前要求的擱置憑證。
  • 擷取 證書頒發機構單位 (CA) 憑證服務伺服器的憑證。

ICertRequest 定義於 Certcli.h 中。 不過,當您建立程式時,請使用 Certsrv.h 作為包含檔案。 Certcli.dll 提供 ICertRequest 介面。 此介面的類型資訊也位於 Certclil.dll,隨附於 Platform Software Development Kit (SDK) 。

憑證服務介面同時支援Apartment線程和自由線程模型。 為了獲得更佳的輸送量,建議使用免費線程處理。

繼承

ICertRequest 介面繼承自 IDispatch 介面。 ICertRequest 也有下列類型的成員:

方法

ICertRequest 介面具有這些方法。

 
ICertRequest::GetCACertificate

傳回憑證服務伺服器的證書頒發機構單位 (CA) 憑證。
ICertRequest::GetCertificate

傳回針對要求發出的憑證作為 X.509 憑證,或選擇性地封裝在公鑰密碼編譯標準 (PKCS)
ICertRequest::GetDispositionMessage

取得人類可讀取的訊息,該訊息會提供憑證要求的目前處置。
ICertRequest::GetLastStatus

取得這個要求的最後一個傳回碼。 這會傳回錯誤碼資訊,而不是要求的處置。
ICertRequest::GetRequestId

取得要求和後續憑證的目前內部要求編號。
ICertRequest::RetrievePending

從先前可能已傳回CR_DISP_INCOMPLETE或CR_DISP_UNDER_SUBMISSION的要求擷取憑證的處置狀態。
ICertRequest::Submit

將要求提交至憑證服務伺服器。

規格需求

需求
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限桌面應用程式]
目標平台 Windows
標頭 certcli.h (包含 Certsrv.h)