Metodo IControlChangeNotify::OnNotify (devicetopology.h)

Il metodo OnNotify notifica al client quando lo stato di un connettore o di una subunit cambia.

Sintassi

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

Parametri

[in] dwSenderProcessId

ID processo del client che ha modificato lo stato del controllo. Se una notifica viene generata da un evento hardware, questo ID processo sarà diverso dall'ID processo del client. Per altre informazioni, vedere la sezione Osservazioni.

[in] pguidEventContext

Puntatore al GUID di contesto per l'evento di modifica del controllo. Il client che avvia la modifica del controllo fornisce questo GUID. Per altre informazioni, vedere la sezione Osservazioni.

Valore restituito

Se il metodo ha esito positivo, viene restituito S_OK. Se ha esito negativo, viene restituito un codice di errore.

Commenti

Un client può usare questo metodo per tenere traccia delle modifiche di controllo apportate da altri processi e dall'hardware. Tuttavia, un client che modifica un'impostazione di controllo può in genere ignorare la notifica generata dalla modifica del controllo. Nell'implementazione del metodo OnNotify , un client può esaminare i parametri dwSenderProcessId e pguidEventContext per individuare se è o un altro client l'origine dell'evento control-change.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	devicetopology.h

Vedi anche

Interfaccia IControlChangeNotify