IOPCItemMgt::SetClientHandles

Previous  Top  Next

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

Descrizione
Cambia il client handle per uno o più items in un gruppo.

Parametri	Descrizione
dwCount	Numero di item di interesse
phServer	Array di Server items handles.
phClient	Array dei nuovi Client item handles da conservare. Non è necessario che i Client Handles siano univoci
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 Restituiti

Return Code	Descrizione
S_OK	L'operazione ha avuto successo.
OPC_E_INVALIDHANDLEOPC_E_INVALIDHANDLE	Il corrispondente Item handle era non valido.

Commenti
In genere, ci si aspetta che i client settino il client handle quando l'item viene aggiunto al gruppo e che in seguito non lo cambino più. Questa funzione è usata soprattutto per settare il client handles di item in public group ai quali i client devono connettersi.