ICertServerPolicy 介面 (certif.h)

ICertServerPolicy 介面可讓原則模組與憑證服務通訊。

注意 憑證服務會透過 ICertPolicy2 介面與原則模塊通訊。
 
ICertServerPolicy 介面是由伺服器引擎匯出,並由原則模組呼叫以執行下列工作:
  • 指定哪些憑證要求做為後續作業的目前內容。
  • 列舉和擷取延伸模組, (包括憑證要求的延伸模組旗標) ,並設定所簽發憑證的延伸模組。
  • 列舉和擷取要求屬性。
  • 擷取憑證要求屬性。
  • 擷取和設定憑證屬性。

呼叫 ICertPolicy::VerifyRequest 方法到傳回為止,無法解析的要求和建構中的憑證可以透過 Context 數據物件存取。 由於原則模組可以藉由呼叫 ICertServerPolicy::SetCertificateProperty 來新增或覆寫要求屬性,因此憑證屬性可能與要求屬性不同。

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

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

繼承

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

方法

ICertServerPolicy 介面具有這些方法。

 
ICertServerPolicy::EnumerateAttributes

擷取目前屬性的名稱,並將內部列舉指標移至下一個屬性。
ICertServerPolicy::EnumerateAttributesClose

釋放與屬性列舉連線的資源。
ICertServerPolicy::EnumerateAttributesSetup

初始化與目前內容相關聯的第一個要求屬性的內部列舉指標。 (ICertServerPolicy.EnumerateAttributesSetup)
ICertServerPolicy::EnumerateExtensions

擷取目前延伸模組 (OID) 的物件標識碼,並將內部列舉指標移至下一個延伸模組。
ICertServerPolicy::EnumerateExtensionsClose

釋放與延伸模組列舉連線的資源。
ICertServerPolicy::EnumerateExtensionsSetup

初始化與目前內容相關聯之第一個憑證延伸模組的內部列舉指標。 (ICertServerPolicy.EnumerateExtensionsSetup)
ICertServerPolicy::GetCertificateExtension

擷取特定的憑證延伸模組。
ICertServerPolicy::GetCertificateExtensionFlags

擷取與最近呼叫 GetCertificateExtension 所取得之擴充功能相關聯的旗標。
ICertServerPolicy::GetCertificateProperty

從憑證傳回具名屬性。 (ICertServerPolicy.GetCertificateProperty)
ICertServerPolicy::GetRequestAttribute

從要求傳回具名屬性。
ICertServerPolicy::GetRequestProperty

從要求擷取特定屬性。
ICertServerPolicy::SetCertificateExtension

將新的延伸模組新增至憑證。
ICertServerPolicy::SetCertificateProperty

若要設定與憑證相關聯的屬性。
ICertServerPolicy::SetContext

指定要作為後續對憑證服務呼叫之內容的要求。

規格需求

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

另請參閱

ICertAdmin::ResubmitRequest

ICertAdmin::SetRequestAttributes

ICertPolicy::VerifyRequest

ICertRequest

ICertRequest::Submit

IDispatch