IOPCItemProperties::LookupItemIDs

Previous  Top  Next

HRESULT   LookupItemIDs(

[in] LPWSTR szItemID,

[in] DWORD dwCount,

[in, size_is(dwCount)] DWORD *pdwPropertyIDs,

[out, string, size_is(,dwCount)] LPWSTR ** ppszNewItemIDs,

[out, size_is(,dwCount)] HRESULT **ppErrors

);

Descrizione
Restituisce un elenco di ITEMIDs (se disponibile) per ciascuno dei codici ID passatigli. Questi indicano l' ITEMID che può essere aggiunto a un OPCGroup e può essere usato per un più efficiente accesso ai dati corrispondenti alle proprietà dell' item.

Parametri	Descrizione
SzItemID	L'ItemID del quale il chiamante vuole visionare l'elenco degli attributi.
DwCount	Il numero di proprietà passate
PdwPropertyIDs	DWORDIDs per le proprietà richieste. Questi IDs vengono restituiti da QueryAvailableProperties
PpszNewItemIDs	La lista di ItemIDs restituita.
PpErrors	Error array indicante se ogni nuovo ItemID è stato restituito.

Codici Restituiti

Codici Restituiti	Descrizione
S_OK	L'operazione ha avuto successo.
OPC_E_UNKNOWNITEMID	L' ItemID non è presente nello spazio indirizzi del server.
OPC_E_INVALIDITEMID	L' ItemID non è sintatticamente valido.
E_OUTOFMEMORY	Non c'è memoria a sufficienza.
E_INVALIDARG	Un argomento passato alla funzione era invalido
E_FAIL	L'operazione non ha avuto successo.

Codici di Errore Restituiti

Codici Restituiti	Descrizione
S_OK	La corrispondente Property ID è stata convertita in un ItemID.
OPC_E_INVALID_PID	La Property ID passata non è definita per questo item.
E_FAIL	La Property ID passata non può essere convertita in un ItemID.

Commenti
Ci si attende che i servers permettano a molte delle proprietà degli item di essere convertite in specifici ItemIDs.
Il chiamante deve liberare i NewItemIDs e gli Errors array restituiti.