Finds an item using a path to that item.
Supported by TerraExplorer Viewer.
HRESULT FindItem (
[in] BSTR PathName,
[out, retval] long *pVal)
Parameters:
PathName – The exact path to the item being searched. Child items are separated by ‘\’ (i.e. “Cities\Boston”).
pVal – Once the method call is returned, pVal contains the ID of the item that was found or zero if no such item was found in the tree
Return Values:
The return value obtained from the returned HRESULT can be one of the following:
|
Return value |
Meaning |
|
S_OK |
Success. |
|
E_FAIL |
Catastrophic failure. |
|
TE_E_MPTNOTLOADED |
An MPT file must be loaded in TerraExplorer for this method to work. |
|
TE_E_NOLICENSE |
You are running TerraExplorer Viewer and therefore do not have permission to work with this interface. |