EnumUsersOnSystemEx

Returns the usernames of and other information applicable to users logged on to a given cluster; you can specify the language in which the names of the user’s active modules are returned. You can return information for users on all application servers, or filter by application, application server, and user.

The user information is returned in arrays that have a one-to-one correspondence.

Note:

To return module names in the system’s default language, use EnumUsersOnSystem.

Syntax

<HsxClient>.EnumUsersOnSystemEx bstrClusterName, vbAllApplications, bstrAppName, vbAllServers, bstrServer, vbAllUsers, lActivityUserID, lLanguageID, pvaralActivitySessionIDs, pbstrAppNames, pbstrServerNames, pvaralActivityUserIDs, pbstrActivityUserNames, pvaralCurrentActivity, pvarabstrModuleNames, pvaradTimeStarted, pvarabstrDesc

Argument	Description
bstrClusterName	String (ByVal). The name of the cluster.
vbAllApplications	Boolean (ByVal). Specifies whether information for all applications is returned. Pass TRUE for all applications, FALSE to specify an application with the bstrAppName argument.
bstrAppName	String (ByVal). The name of the application server for which to return information. This argument is used only if the vbAllApplications argument is set to FALSE.
vbAllServers	Boolean (ByVal). Specifies whether information for all application servers is returned. Pass TRUE for all application servers, FALSE to specify an application server with the bstrServer argument.
bstrServer	String (ByVal). The name of the application server for which to return information. This argument is used only if the vbAllServers argument is set to FALSE.
vbAllUsers	Boolean (ByVal). Specifies whether information for all users is returned. Pass TRUE for all users, FALSE to specify a user with the lActivityUserID argument.
lActivityUserID	Long (ByVal). The activity user ID of the user for whom to return information. This argument is used only if the vbAllUsers argument is set to FALSE. To get a user’s activity user ID, use HsvSystemInfo.GetActivityUserID.
lLanguageID	Long (ByVal). The ID of the language in which to return module names. Tip: You can use the HsvResourceManager method GetAvailableLanguages to obtain the IDs of the languages valid for a given release.
pvaralActivitySessionIDs	Variant array. Returns the internal IDs of the user sessions. The array is returned as a Long subtype.
pbstrAppNames	Variant array. Returns the names of the applications to which users are logged on. The array is returned as a String subtype.
pbstrServerNames	Variant array. Returns the names of the application servers on which users are logged on. The array is returned as a String subtype.
pvaralActivityUserIDs	Variant array. Returns the activity user IDs of the users who are logged on. The array is returned as a Long subtype.
pbstrActivityUserNames	Variant array. Returns the usernames of the users who are logged on. The array is returned as a String subtype.
pvaralCurrentActivity	Variant array. Returns the IDs of the users’ current activities. Valid values are represented by the HFMConstants type library constants listed in User Activity Constants. The array is returned as a Long subtype.
pvarabstrModuleNames	Variant array. Returns the names of the modules in which the users are active. The array is returned as a String subtype.
pvaradTimeStarted	Variant array. Returns the timestamps of when the users accessed the system. Array items are formatted as Doubles that can be cast to the Date format. The array is returned as a Double subtype.
pvarabstrDesc	Variant array. Future use. An array is returned, but you can ignore it.