IOPCItemMgt::SetDatatypes

Previous  Top  Next

HRESULT SetDatatypes(
   [in] DWORD dwCount,
   [in, size_is(dwCount)] OPCHANDLE * phServer,
   [in, size_is(dwCount)] VARTYPE * pRequestedDatatypes,
   [out, size_is(,dwCount)] HRESULT ** ppErrors
   );
Descrizione
Cambia il tipo di dato richiesto per uno o più item in a gruppo.

Parameters	Descrizione
DwCount	Numero di item di interesse
PhServer	Array di Server items handles.
PrequestedDatatypes	Array dei nuovi Datatypes Requested da immagazzinare.
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

Codici Restituiti	Descrizione
S_OK	L'operazione ha avuto successo.
OPC_E_INVALIDHANDLE	Il corrispondente Item handle era non valido.
OPC_E_BADTYPE	Il datatype richiesto non può essere supportato per questo item. Il precedente requested datatype è lasciato invariato.

Commenti
In genere, ci si aspetta che i client settino il requested datatype quando l'item viene aggiunto al gruppo e che in seguito non lo cambino più. Questa funzione è usata soprattutto per settare il datatype di item in public group ai quali i client devono connettersi.
Come alternativa all'OPC_E_BADTPYE è possibile per il server ritornare ogni FAILED error attraverso un VariantChangeType o un VariantChangeTypeEx.