Acquires the name of a certain item using its ItemID.
Supported by TerraExplorer Viewer.
HRESULT GetItemName (
[in] long ItemID,
[out, retval] BSTR *ItemText)
Parameters:
ItemID – The ID of the item whose name you are looking for.
ItemText – Once the method call is returned, ItemText contains the name of the item as it appears in the Information Window.
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. |
|
E_INVALIDARG |
There is a problem with one or more of the arguments passed to this method. Use the IErrorInfo interface to extract more information about this error. |
Remarks:
This method can be used while traversing the tree to obtain the real names of the items in the tree.