IOPCBrowseServerAddressSpace:: GetItemID

Previous  Top  Next

HRESULT GetItemID(

[in] LPCWSTR szItemDataID,

[out, string] LPWSTR * szItemID

);

Descrizione
Fornisce un modo per mettere assieme un ITEM ID 'pienamente qualificato' in uno spazio gerarchico. Ciò è richiesto poiché le funzioni di sfoglio, restituiscono solo i componenti o tokens che formano un ITEMID e non restituiscono delimitatori per separare questi tokens.

Parametri	Descrizione
szItemDataID	Il nome di un BRANCH o di un LEAF del livello corrente, o un puntatore a una stringa NUL. Passando una stringa NUL, si avrà indietro una stringa che rappresenta la posizione corrente nella gerarchia.
szItemID	Dove restituire l'ItemID.

Codici Restituiti

Codici Restituiti	Descrizione
E_FAIL	L'operazione non ha avuto successo.
E_INVALIDARG	Un argomento passato alla funzione era invalido
E_OUTOFMEMORY	Non c'è memoria a sufficienza.
S_OK	L'operazione ha avuto successo.

Commenti
Questa funzione non necessita di essere chiamata per uno spazio FLAT. Se ciò viene fatto, allora verrà semplicemente restituita la stessa stringa che gli era stata passata.
E' permesso formare un ItemID che rappresenta un BRANCH (e.g. AREA1.REACTOR10). Ciò può accadere se viene passato un BRANCH (AREA1)piuttosto che una LEAF (CURRENT_VALUE). La stringa risultante può dare errore se viene passata a AddItem, ma può essere passata a ChangeBrowsePosition usando OPC_BROWSE_TO.
Il client deve liberare la stringa restituita.
ItemID è l'unica chiave di accesso al dato. E' considerato il 'cosa' o il 'dove' che permette al server di connettersi ad una sorgente dati.