IOPCBrowseServerAddressSpace:: ChangeBrowsePosition
Previous  Top  Next

HRESULT ChangeBrowsePosition(  
[in] OPCBROWSEDIRECTION dwBrowseDirection,  
[in, string] LPCWSTR szString  
);  
 
Descrizione
Fornisce un modo per muoversi 'up' o 'down' o 'to' in uno spazio gerarchico.

Parametri
Descrizione
dwBrowseDirection
OPC_BROWSE_UP o OPC_BROWSE_DOWN o OPC_BROWSE_TO.
szString
Per DOWN,il nome del ramo in cui spostarsi. Questa potrebbe essere una delle stringhe restituirte da BrowseOPCItemIDs.
Per esempio, REACTOR10
Per UP questo parametro viene ignorato e doverbbe puntare a una stringa NUL.
Per TO un nome completo ( per sempio quello resttituito da GetItemID) o un puntatore a una stringa NUL per andare alla 'root'.
Pe esempio. AREA1.REACTOR10.TIC1001


Codici Restituiti

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


Commenti
La funzione restituirà E_FAIL se chiamata per uno spazio FLAT .
Viene restituito un errore se la stringa passata non rappresenta un ramo.
Spostandosi verso l'alto (UP) dalla 'root' restituirà E_FAIL.