This method saves the specified group to a FLY file. For security reasons the file is saved to a predefined “Skyline\TerraExplorer” folder in the “Application Data” space of the current user. You can use %APPDATA% in Windows Explorer to locate the path on your computer. See: LoadFlyLayer for details on how to load a fly file from the “Application Data” folder.
Note: If the folder contains a file by the same name, the existing file is overwritten without a prompt.
Note: The Application Data folder path changes between different users and different Windows operating systems. To find the path used by your client look at the %APPDATA% environment variable.
HRESULT SaveFlyLayer(
[in] BSTR FlyFile,
[in] long GroupID)
Parameters:
FlyFile – The name of the
FLY file to be saved. If it is
not specified, a FLY extension is added to the file name
automatically.
Note: A file name with a
full path cannot be used here.
GroupID – The group that is sorted. If it is set to zero, the root group is sorted. You can obtain the GroupID by one of the following methods:
Create the group using IInformationTree5::CreateGroup.
Find the group, if you know the name, using IInformationTree5::FindItem.
Traverse the Tree using IInformationTree5 methods such as GetNextItem(), until you come to the desired GroupID.
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_NOLICENSE |
You are running TerraExplorer Viewer and therefore do not have permission to work with this interface. |