ITcSysManager3::LookupTreeItemById

The LookupTreeItemById() method returns a ITcTreeItem pointer of a tree item given by it's full path name.

HRESULT LookupTreeItemById(longitemType, longitemId, ITcSmTreeItem**pipItem); 

Parameters

itemType

[in] Item type of the TreeItem to find.

itemId

[in] ID of the TreeItem

pipItem

[out, retval] points to the location of a ITcSmTreeItem interface pointer on return. The interface pointer gives access to specific methods belonging to the tree item.

Return Values

S_OK

function returns successfully.

TSM_E_ITEMNOTFOUND (0x98510001)

the itemType itemId combination doesn't qualify a valid tree item.