ICertAdmin 介面 (certadm.h)

ICertAdmin 介面提供正確授權用戶端的管理功能。

ICertAdmin 介面可用來執行下列工作:

  • 授權或拒絕憑證要求。
  • 撤銷發行的憑證。
  • 觸發產生 證書吊銷清單 (CRL) 。
  • 取得伺服器的目前CRL。
  • 判斷憑證是否有效。
當您使用 ICertAdmin 介面時,您只能存取要求屬性和憑證延伸模組,但無法直接存取其他要求和憑證屬性。

ICertAdmin 定義於 Certadm.h 中。 不過,當您建立程式時,請使用 Certsrv.h 作為 include 檔案。 另一方面,Certadm.dll 提供 ICertAdmin 介面的實作。 此介面的類型資訊也位於 Certadml.dll,隨附於平臺軟體開發工具包 (SDK) 。

系統管理工作使用DCOM。 呼叫這個介面方法的程序代碼,如舊版 Certadm.h 中所定義,只要客戶端和伺服器都執行相同的 Windows 作業系統,就會在 Windows 伺服器上執行。

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

繼承

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

方法

ICertAdmin 介面具有這些方法。

 
ICertAdmin::D enyRequest

拒絕擱置中的指定憑證要求。
ICertAdmin::GetCRL

擷取憑證服務證書頒發機構單位 (CA) 的目前證書吊銷清單 (CRL) 。
ICertAdmin::GetRevocationReason

傳回撤銷憑證的原因。 此方法最初是在 ICertAdmin 介面中定義。
ICertAdmin::ImportCertificate

取得先前發行的憑證,並將其匯入證書頒發機構單位的 (CA) 資料庫。 此方法最初是在 ICertAdmin 介面中定義。
ICertAdmin::IsValidCertificate

針對證書頒發機構單位驗證憑證, (CA) 金鑰,並檢查憑證是否已撤銷。 此方法最初是在 ICertAdmin 介面中定義。
ICertAdmin::P ublishCRL

將要求傳送至憑證服務證書頒發機構單位 (CA) ,以發佈新的證書吊銷清單 (CRL) 。 此方法最初是在 ICertAdmin 介面中引進。
ICertAdmin::ResubmitRequest

將指定的憑證要求提交至指定證書頒發機構單位的原則模組。 此方法最初是在 ICertAdmin 介面中引進。
ICertAdmin::RevokeCertificate

撤銷指定日期或立即的憑證。 此方法最初是在 ICertAdmin 介面中定義。
ICertAdmin::SetCertificateExtension

將新的延伸模組新增至發行的憑證,以響應憑證要求。 這個方法最初是由 ICertAdmin 介面所定義。
ICertAdmin::SetRequestAttributes

設定指定暫止憑證要求中的屬性。 此方法最初是在 ICertAdmin 介面中定義。

規格需求

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