ITcSmTreeItem::LookupChild

Returns a ITcTreeItem pointer of a descendant child tree item given by it's relative path name.

HRESULT LookupChild(BSTRbstrName, ITcSmTreeItem**pipItem);

Parameters

bstrName

[in] relative path of the tree item you are looking for. The relative path name is required, and each branch must be separated by a circumflex accent '^' or a tab.

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 path name does not qualify an existing tree item.