UserList()

Get a list of Users for the Session Network/Mailbox.


      Public Function UserList(ByVal SessionID As 
      String, 
      _
                         ByVal Name As String) 
      _
                         
      As UserIDInfo()

Parameters

SessionID: String - GUID; The current session's GUID in string format. This is a 32-character hexidecimal string in the format:
00000000-0000-0000-0000-000000000000. This is the value returned by the Login() function.
Name: String(0,40); A generic variable that is used to match any type of Name field (e.g. FirstName, LastName, LoginName, etc.).

Returns

UserIDInfo Collection

UserID: Integer; A numeric value used to represent a specific user on the system.
LoginName: String(8,16); A user's login name.
RecoveryQuestion: String(0,50); A user defined question used to restore lost password or to activate an account with too many failed logins.
FirstName: String(1,50); A user's first name.
LastName: String(1,50); A user's last name.
Company: String(0,50); A company name.
Email: String(1,50); A valid Email address.
Phone: String(0,20); A phone number.
CellPhone: String(0,20); A Cell Phone number.
CellCarrier: Short - CellCarrier ENUM; A value to indicate the cell phone carrier in order to send SMS text messages.
TimeZoneOffset: Short; The number of minutes + or - the user local time is from UTC.
NetworkID: Integer; The NetworkID assigned to Network on ECGrid.
MailboxID: Integer; The MailboxID assigned to a Mailbox within a Network on ECGrid.
AuthLevel: Short - AuthLevel ENUM; The Authority Level for system access.
Created: Date; The date/time (UTC) the record was created.
Modified: Date; The date/time (UTC) the record was last modified.
LastLogin: Date; The last date/time this User logged in.
Status: Short - ECGridOSv0200.Status ENUM; A numeric value representing the entry's status.
LockedOut: Boolean; Whether or not the User is currently locked out.
OpenSessions: Short; Number of current open sessions for this User.

Remarks

The Name parameter is treated as a wildcard and will match all or part of a name in the LoginName, FirstName and LastName fields. If a empty string ("") is passed, it will return all records in the Session Network/Mailbox.

If the Session Mailbox is 0, then all users within the Network will be returned.

Use UserListEx() to list users in other Network/Mailboxes.

Example

Visual Basic

[insert code sample]