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 |