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]

EventID: 1013

See Also

UserListEx()
Session Network/Mailbox


© 2008-2011, Loren Data Corp.
All rights reserved.
ECGrid is a registered service mark of Loren Data Corp.
ECGridOS is a service mark of Loren Data Corp.