共用方式為


定義 Notify 類別

必須實作 Notify 類別,使其繼承自 INetCfgComponentControl 介面。 不過,如果通知物件執行某些作業,則必須實作通知類別以繼承自下列介面:

  • 如果 notify 物件執行與安裝、升級和移除擁有物件的元件相關的作業,相關聯的 notify 類別必須繼承自 INetCfgComponentSetup 介面。

  • 如果 notify 物件顯示擁有物件的元件自訂屬性頁,相關聯的 notify 類別必須繼承自 INetCfgComponentPropertyUi 介面。

  • 如果 notify 物件評估網路設定子系統將擁有物件的元件系結至其他網路元件的方式變更,相關聯的 notify 類別必須繼承自 INetCfgComponentNotifyBinding 介面。

  • 如果 notify 物件評估可能會影響擁有物件的元件之網路組態的變更,相關聯的 notify 類別必須繼承自 INetCfgComponentNotifyGlobal 介面。

通知類別內的某些資料成員應該定義為所有通知物件的通用。 特定資料成員應定義為其元件專屬。 所有通知物件都應該定義的資料成員包括:

  • 擁有 INetCfgComponent 介面類別型物件的網路元件實例指標。 notify 物件的實例會使用此指標來存取和控制擁有物件的元件。

  • INetCfg介面類別型之網路組態物件的實例指標。 notify 物件的實例會使用此指標來存取網路組態的所有層面。

  • 用來儲存擁有 notify 物件的元件之參數資訊的變數

  • 變數,指定先前執行通知物件的動作。 定義常數,以指出通知物件可能執行的不同動作。 當網路設定子系統呼叫 notify 物件的 INetCfgComponentControl::ApplyRegistryChanges 方法以將設定變更套用至登錄時, ApplyRegistryChanges 會使用此變數來判斷如何進行登錄變更。 例如,如果通知物件先前執行了與安裝在其 INetCfgComponentSetup::Install 方法中擁有物件的元件相關的作業, Install 應該設定此變數來指出動作為安裝。

  • HKEY類型的登錄機碼。 notify 物件會呼叫擁有物件的 元件 INetCfgComponent::OpenParamKey 方法,以開啟及擷取包含元件參數的登錄機碼。 notify 物件接著會將 HKEY 成員設定為該索引鍵。

定義通知類別的建構函式和解構函式。 也請考慮定義只有 notify 類別可以使用的私人方法。

所有 IUnknown 介面方法都應該針對通知類別實作。 如果 notify 類別繼承自上述清單中所述的任何選擇性介面,則必須實作這些介面的所有方法。 請注意,E_NOTIMPL不是任何通知物件介面方法的有效傳回型別。 如果 notify 物件不需要特定方法的實作,只要實作 方法即可傳回S_OK。