IOPCAsyncIO2::SetEnable

Previous  Top  Next

HRESULT SetEnable(
   [in] BOOL bEnable
   );
Descrizione
Controlla l'operazione di OnDataChange. Essenzialmente setta Enable a FALSE e quindi disabilita ogni callback OnDataChange con transaction ID a 0.

Parametri	Descrizione
bEnable	TRUE abilita le callback OnDataChange, FALSE disabilita le callback OnDataChange.

Codici Restituiti

Codici Restituiti	Descrizione
S_OK	L'operazione ha avuto successo.
CONNECT_E_NOCONNECTION	Il client non ha registrato alcuna callback attraverso IConnectionPoint::Advise.
E_FAIL	L'operazione non ha avuto successo.

Commenti
Il valore iniziale di questa variabile quando il gruppo viene creato è TRUE e quindi le callback OnDataChange sono abilitate per default.
Questa funzione si propone di permettere una connessione ad un gruppo senza per questo abilitare necessariamente la notifica di OnDataChange.
Anche se un client non intende usare la OnDataChange, esso si dovrebbe tuttavia preparare a trattare con una o più callback OnDataChange che potrebbero arrivare prima che il client abbia il tempo di disabilitarle.
Non è influenzata dalla operazione Refresh2().