IOPCItemMgt::SetActiveState

Previous  Top  Next

HRESULT SetActiveState(
   [in] DWORD dwCount,
   [in, size_is(dwCount)] OPCHANDLE * phServer,
   [in] BOOL bActive,
   [out, size_is(,dwCount)] HRESULT ** ppErrors
   );


Descrizione
Setta uno o più item di un gruppo come attivi o disattivi. Inoltre controlla se possono essere ottenuti dati validi da questi item attraverso una Read CACHE e se sono inclusi o meno nella sottodescrizione IAdvise del gruppo.

Parametri	Descrizione
dwCount	Numero di item di interesse
phServer	Array di Server items handles.
bActive	TRUE se gli item devono essere attivati. FALSE se gli item devono essere disattivati.
ppErrors	Array di HRESULT. Indica per quali item l'operazione si è conclusa con successo.

Codici Restituiti

Codici Restituiti	Descrizione
S_OK	La funzione ha avuto successo.
S_FALSE	La funzione ha avuto un successo parziale. Si guardi il ppErrors per determinare cosa è accaduto.
E_FAIL	La funzione non ha avuto successo.

Codici Di Errore Restituiti

Codici Restituiti	Descrizione
S_OK	L'operazione ha avuto successo.
OPC_E_INVALIDHANDLE	Il corrispondente Item handle era non valido.

Commenti
Disattivando gli item non avverrà alcun callback (per definizione le callback non avvengono per item inattivi). Attivando gli item generalmente si avrà come risultato una callback in un'interfaccia IAdvise al susseguente periodo di UpdateRate.