This documentation supports the 9.1 version of Remedy Action Request System.

To view the latest version, select the version from the Product version menu.

ARGetListUser

Note

You can continue to use C APIs to customize your application, but C APIs are not enhanced to support new capabilities provided by Java APIs and REST APIs.

Description

Retrieves a list of users from the specified BMC Remedy AR System server. You can retrieve information about the current user, all registered users, or all users currently accessing the server.

Privileges

Information about the current user can be retrieved by all users. Access to information about other users is limited to users with BMC Remedy AR System administrator privileges.

Synopsis

#include "ar.h"
#include "arerrno.h"
#include "arextern.h"
#include "arstruct.h"

int ARGetListUser(
   ARControlStruct *control,
   unsigned int userListType,
   ARTimestamp changedSince,
   ARUserInfoList *userList,
   ARStatusList *status)

Input arguments

control

The control record for the operation. It contains information about the user requesting the operation, where that operation is to be performed, and which session is used to perform it. The user and server fields are required.

userListType

A value that indicates the user type to retrieve.

0:

Retrieve the current user (AR_USER_LIST_MYSELF).

1:

Retrieve all registered users (AR_USER_LIST_REGISTERED).

2:

Retrieve all users currently accessing the server (AR_USER_LIST_CURRENT).

3:

Retrieve all users with accounts marked invalid (AR_USER_LIST_INVALID) .

4:

Retrieve all users with application licenses (AR_USER_LIST_APPLICATION).

 

changedSince

A time stamp that limits the list entries retrieved to those modified after the specified time. Specify 0 for this parameter to retrieve entries with any modification time stamp. The changedSince parameter applies only if the userListType parameter is set to: AR_USER_LIST_REGISTERED.

Return values

userList

List of zero or more users that match the criteria defined by the userListType parameter. The list contains the user name and license type. If you retrieve the current user, the list also contains a time stamp that specifies the last server access. The system returns a list with zero items if no users match the specified criteria.

status

A list of zero or more notes, warnings, or errors generated from a call to this function. For a description of all possible values, see Error checking.

See also

ARGetListGroup. See FreeAR for: FreeARUserInfoList, FreeARStatusList.

Was this page helpful? Yes No Submitting... Thank you

Comments