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) |