ITcSysManager::LookupTreeItem
Searches the project tree for an element based on its path name (e.g. TIID^Device 1^Box 1) and returns the matching Tree Item. Supports searching within nested projects. If errors occur, a detailed IErrorInfo entry is created.
Signature
HRESULT LookupTreeItem(BSTR bstrItem, ITcSmTreeItem** pipItem);
Parameter
|
Name |
Type |
Description |
|---|---|---|
|
bstrItem |
BSTR |
[in] Path name or name of the Tree Item, separated by a caret ( |
Return value
|
Name |
Type |
Description |
|---|---|---|
|
pipItem |
ITcSmTreeItem** |
[out, retval] The resolved Tree Item. |
|
(HRESULT) |
HRESULT |
|
Error codes
-
TSM_E_ITEMNOTFOUND: Path could not be resolved. -
E_ACCESSDENIED: System Manager is disabled.
See also
- ITcSysManager6::TryLookupTreeItem: non-throwing variant
- ITcSysManager3::LookupTreeItemById: Search by ID
- ITcSmTreeItem: return type