Definiowanie klasy Notify

Klasy powiadomień muszą być zaimplementowane tak, aby dziedziczyły z interfejsu INetCfgComponentControl. Jeśli jednak obiekty powiadamiania wykonują pewne operacje, klasy powiadamiania muszą być również zaimplementowane w celu dziedziczenia z następujących interfejsów:

• Jeśli obiekt powiadamiania wykonuje operacje związane z instalowaniem, uaktualnianiem i usuwaniem składnika będącego właścicielem obiektu, skojarzona klasa notify musi dziedziczyć z interfejsu INetCfgComponentSetup.

• Jeśli obiekt powiadamiania wyświetla niestandardowe strony właściwości składnika będącego właścicielem obiektu, skojarzona klasa powiadamiania musi dziedziczyć z interfejsu INetCfgComponentPropertyUi.

• Jeśli obiekt powiadamiania ocenia zmiany związane ze sposobem, w jaki podsystem konfiguracji sieci wiąże komponent posiadający ten obiekt z innymi składnikami sieciowymi, to skojarzona klasa powiadamiania musi dziedziczyć z interfejsu INetCfgComponentNotifyBinding.

• Jeśli obiekt powiadamiania ocenia zmiany konfiguracji sieci, które mogą mieć wpływ na składnik, który jest właścicielem obiektu, skojarzona klasa notify musi dziedziczyć z interfejsu INetCfgComponentNotifyGlobal.

Niektóre składowe danych w klasach powiadamiania powinny być zdefiniowane jako wspólne dla wszystkich obiektów powiadamiania. Niektóre elementy członkowskie danych powinny być zdefiniowane jako specyficzne dla ich składnika. Składowe danych, które powinny definiować wszystkie obiekty powiadamiania, obejmują:

• Wskaźnik do instancji składnika sieciowego będącej właścicielem obiektu typu o interfejsie. Instancja obiektu powiadamiającego używa tego wskaźnika do uzyskiwania dostępu do komponentu, który jest właścicielem obiektu, i jego kontrolowania.

• Wskaźnik do instancji obiektu konfiguracji sieci typu INetCfg interfejs. Instancja obiektu powiadamiania używa tego wskaźnika, aby uzyskać dostęp do wszystkich aspektów konfiguracji sieci.

• Zmienne do przechowywania informacji o parametrach składnika, który jest właścicielem obiektu powiadamiania

• Zmienna określająca akcję, którą wcześniej wykonał obiekt powiadamiania. Zdefiniuj stałe, aby wskazać różne działania, które mogą wykonywać mechanizmy powiadamiania obiektów. Gdy podsystem konfiguracji sieci wywołuje metodę INetCfgComponentControl::ApplyRegistryChanges, aby zastosować zmiany konfiguracji w rejestrze, ApplyRegistryChanges wykorzystuje tę zmienną do określenia sposobu wprowadzania zmian w rejestrze. Jeśli na przykład obiekt powiadamiania wcześniej wykonywał operacje związane z instalacją składnika, którego jest właścicielem, w swojej metodzie INetCfgComponentSetup::Install, Install powinna ustawić tę zmienną, aby oznaczać akcję jako instalację.

• Klucz rejestru typu HKEY. Obiekt notify wywołuje metodę INetCfgComponent::OpenParamKey metody składnika, który jest właścicielem obiektu do otwarcia i pobrania klucza rejestru zawierającego parametry składnika. Obiekt notify następnie ustawia element członkowski HKEY na ten klucz.

Zdefiniuj konstruktor i destruktor dla klasy notify. Należy również rozważyć zdefiniowanie metod prywatnych, których może używać tylko klasa powiadamiania.

Wszystkie metody interfejsu IUnknown powinny być implementowane dla klasy notify. Jeśli klasa notify dziedziczy z dowolnego z opcjonalnych interfejsów zanotowanych na powyższej liście, należy zaimplementować wszystkie metody tych interfejsów. Należy pamiętać, że E_NOTIMPL nie jest prawidłowym typem zwracanym dla żadnej z metod interfejsów obiektu powiadamiania. Jeśli obiekt powiadamiania nie wymaga implementacji określonej metody, po prostu zaimplementuj metodę, aby zwrócić S_OK.