IControlChangeNotify::OnNotify-Methode (devicetopology.h)

Die OnNotify-Methode benachrichtigt den Client, wenn sich die status eines Connectors oder einer Untereinheit ändert.

Syntax

HRESULT OnNotify(
  [in] DWORD   dwSenderProcessId,
  [in] LPCGUID pguidEventContext
);

Parameter

[in] dwSenderProcessId

Die Prozess-ID des Clients, der den Status des Steuerelements geändert hat. Wenn eine Benachrichtigung durch ein Hardwareereignis generiert wird, unterscheidet sich diese Prozess-ID von der Prozess-ID des Clients. Weitere Informationen finden Sie in den Hinweisen.

[in] pguidEventContext

Ein Zeiger auf die Kontext-GUID für das Steuerelementänderungsereignis. Der Client, der die Steuerelementänderung initiiert, stellt diese GUID bereit. Weitere Informationen finden Sie in den Hinweisen.

Rückgabewert

Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Bei einem Fehler wird ein Fehlercode zurückgegeben.

Hinweise

Ein Client kann diese Methode verwenden, um Steuerungsänderungen nachzuverfolgen, die von anderen Prozessen und von der Hardware vorgenommen werden. Ein Client, der eine Steuerelementeinstellung ändert, kann jedoch in der Regel die Benachrichtigung ignorieren, die von der Steuerelementänderung generiert wird. Bei der Implementierung der OnNotify-Methode kann ein Client die Parameter dwSenderProcessId und pguidEventContext untersuchen, um zu ermitteln, ob er oder ein anderer Client die Quelle des Steuerelementänderungsereignisses ist.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile devicetopology.h

Weitere Informationen

IControlChangeNotify-Schnittstelle