DatabaseHandle :: GetWorkspace - Get workspace names

The function returns the workspaces defined below an existing workspace or database. The function returns workspace names by index sorted in alphabetic order (first entry is retrieved with index 0). Only workspaces on a given level are returned. To get workspaces on lower levels one has to pass the root path for the lower level.

Workspace information is buffered when retrieving it the first time. To refresh the internal workspace list one should pass the refresh option (YES).

For retrieving workspaces owned by the user a user name can be passed. Not passing a user name will return all workspaces.

The name for the workspace is returned in ws_name in addition when passing a pointer to a character array. Otherwise the name is returned only in the result area of the property handle, which might be destroyed after the next property handle function call.