ICertExit 介面 (certexit.h)

  • 發行項

ICertExit 介面提供憑證服務伺服器與結束模組之間的通訊。

注意 結束模組可以使用 ICertServerExit 介面與憑證服務伺服器通訊。
 
憑證服務伺服器會呼叫 ICertExit 方法來執行下列工作：
  • 初始化憑證服務伺服器。
  • 通知結束模組發生憑證發行、 證書吊銷清單 (CRL) 發行或伺服器關機等事件。
  • 擷取結束模組的描述。

ICertExit 定義於 Certexit.h 中。 不過，當您建立程式時，請使用 Certsrv.h 作為包含檔案。

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

繼承

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

方法

ICertExit 介面具有這些方法。

 
ICertExit：：GetDescription

傳回結束模組及其函式的人類可讀描述。
ICertExit：：Initialize

當伺服器引擎初始化本身時，由伺服器引擎呼叫。
ICertExit：：Notify

由伺服器引擎呼叫，以通知結束模組已發生事件。

備註

ICertExit 的實作者也應該實作 ICertManageModule。 此外，實作 ICertExit 之類別的 ProgID 必須符合命名慣例。 具體而言，ProgID 的格式必須是：

“MyApp.結束」

其中 MyApp 是識別應用程式的規範。 例如，在 C++ 中，下列程式代碼可用於實作 ICertExit 的類別DECLARE_REGISTRY宏 (CMyCertExitModule) 。

DECLARE_REGISTRY(
    CMyCertExitModule,
    L"MyCode.Exit.1",
    L"MyCode.Exit",
    IDS_CERTEXITMODULE_DESC,
    THREADFLAGS_BOTH)

針對上一個範例，IDS_CERTEXITMODULE_DESC值是描述 類別之字串的資源檔 (.rc) 應用程式特定識別符。

Certmod.h 中定義的字串常數可用來簡化命名慣例。

常數 值
wszCERTEXITMODULE_POSTFIX TEXT (”。結束“)
 

憑證服務伺服器上一次不能註冊多個 Visual Basic Scripting Edition 結束模組。 如果已註冊多個 Visual Basic Scripting Edition 結束模組，證書頒發機構單位 MMC 嵌入式管理單元、憑證服務應用程式或 certutil 命令行程式可能會產生錯誤。 請注意，Visual Basic Scripting Edition 開發環境會在成功建置時自動註冊 DLL。 因此，當一個 Visual Basic Scripting Edition 結束模組已註冊，並建立另一個 Visual Basic Scripting Edition 結束模組時，您可能會遇到這種情況。 若要避免這種情況，您必須透過命令行指令 regsvr32 /u FileName.dll取消註冊其中一個 Visual Basic Scripting Edition 結束模組，其中 FileName.dll 是不打算成為作用中之 Visual Basic Scripting Edition 結束模組的名稱。

Visual Basic Scripting Edition 中 ICertExit 的實作者必須以下列格式命名其專案：

“MyApp”

其中 MyApp 是識別應用程式的規範;此外，實作 ICertExit 的類別必須命名為 「Exit」。

規格需求

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

另請參閱

ICertServerExit

IDispatch