Click or drag to resize
ClientUserListAdvanced Method (Int32, Int32)
Returns a List of users in the current organization.

Namespace: MOVEit.DMZ.API
Assembly: MOVEit.DMZ.API (in MOVEit.DMZ.API.dll) Version: 9.0.0.0
Syntax
public List<MOVEitUserInfo> UserListAdvanced(
	int Page,
	int EntriesPerPage
)

Parameters

Page
Type: SystemInt32
Page number to return (starting with 1). If the value provided is larger than the number of pages in the current list, the first page of results will be returned.
EntriesPerPage
Type: SystemInt32
Number of entries to return in each page of results (minimum 5, maximum 1000).

Return Value

Type: ListMOVEitUserInfo
List containing list results if successful; otherwise, null
Remarks

Returns an empty List if no users are found or

null
if the currently authorized user is not permitted to get this information.

This function allows more customization in which users are returned then the UserList(String) function. Most importantly, this function supports "paging", which allows programs to separate user lists into more manageable "pages", which contain only some of the results of the list. This is necessary when trying to list a large number of users, as MOVEit Transfer enforces a 1000 entry limit on the number of users that can be returned from a single listing, for performance reasons. The Page argument specifies the page number to return (starting with 1). The EntriesPerPage argument determines the number of entries that will be returned in each page (minimum 5, maximum 1000). Once the first page of the list has returned, the class-level UserListCount value will contain the total number of users available via the provided filters. The number of pages of users that can be retrieved can then be calculated using that value and the EntriesPerPage argument via the following algorithm:

if ((objAPI.UserListCount mod EntriesPerPage) > 0) 
{
    number_of_pages = (objAPI.UserListCount div EntriesPerPage) + 1
} 
else 
{
    number_of_pages = objAPI.UserListCount div EntriesPerPage
}

If the Page argument is set to a value higher than the total number of pages available, the first page of results will be returned.

See Also