IOPCItemMgt::RemoveItems

Previous  Top  Next

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

Descrizione
Rimuove (cancella) gli item da un gruppo. È essenzialmente l'inverso di AddItems.

Parametri	Descrizione
DwCount	Numero di item da rimuovere
phServer	Array di server item handles. Erano stati ritornati dall'AddItem.
ppErrors	Array di HRESULTs. Indica quali item sono stati rimossi 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.
OPC_E_PUBLIC	Impossibile rimuovere item da un public group.

Codici Di Errore Restituiti

Codici Restituiti	Descrizione
S_OK	Il corrispondente item è stato rimosso.
OPC_E_INVALIDHANDLE	Il corrispondente Item handle era non valido.

Commenti
Aggiungendo o rimuovendo item da un gruppo non si hanno effetti sullo spazio di indirizzi del server o del device fisico. Una operazione del genere indica solamente se il client è interessato a quell'item o meno.
Gli item non sono realmente oggetti in una custom interface (non hanno interfacce), e no esiste nessun concetto contatore di riferimenti per gli item. Il client dovrebbe essere sicuro che non esistano riferimenti remoti all'item rimosso.
Non è possibile rimuovere item da un public group.