IOPCItemMgt::ValidateItems

Previous  Top  Next

HRESULT ValidateItems(
   [in] DWORD dwCount,
   [in, size_is(dwCount)] OPCITEMDEF * pItemArray,
   [in] BOOL bBlobUpdate,
   [out, size_is(,dwCount)] OPCITEMRESULT ** ppValidationResults,
   [out, size_is(,dwCount)] HRESULT ** ppErrors
   );

Descrizione
Determina se un Item è valido (potrebbe essere stato aggiunto senza dare errore). Ritorna informazioni sull'item come il canonical datatype. Non ha alcuno effetto sul gruppo

Parametri	Descrizione
DwCount	Numero di item da validare
PItemArray	Array di OPCITEMDEF. I suoi elementi contengono tutte le informazioni che il server deve conoscere compreso l'access path, definition e il datatype richiesto
BBlobUpdate	Se diverso da zero (e il server supporta i Blob) il server dovrebbe ritornare l'aggiornamento dei Blobs in OPCITEMRESULT. Se zero il server non ritornerà alcun Blob in OPCITEMRESULT.
PpValidationResults	Array di OPCITEMRESULT. Contiene informazioni addizionali sugli item compreso il canonical datatype.
ppErrors	Array di HRESULT. Dice al client quali degli item sono stati validati con successo. Per ogni item non validato ritorna una spiegazione del fallimento.

Codici Di Errore Restituiti

Codici Restituiti	Descrizione
E_FAIL	L'operazione non è stata conclusa con successo.
E_OUTOFMEMORY	Memoria insufficiente.
E_INVALIDARG	Un argomento della funzione era non valido.
S_OK	Operazione conclusa con successo.
S_FALSE	Operazione completata con un parziale successo. Si riferisce ad un errore individuale ritornato per un'analisi degli errori.

Codici Restituiti

Return Code	Descrizione
S_OK	La funzione ha avuto successo per questo Item.
OPC_E_INVALIDITEMID	L'ItemID è sintatticamente non valido.
OPC_E_UNKNOWNITEMID	L'ItemID non è nello spazio di indirizzi del server.
OPC_E_BADTYPE	Il tipo di dato richiesto non può essere restituito per questo Item.
E_FAIL	La funzione non ha avuto successo per questo item.
OPC_E_UNKNOWNPATH	Il server non conosce l'access path dell'item.

Commenti
I client devono liberare tutta la memoria associata ad un OPCITEMRESULT compreso il BLOB.
Come alternativa all'OPC_E_BADTPYE è possibile per il server ritornare un FAILED error attraverso un VariantChangeType o un VariantChangeTypeEx.