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 |