SYNOPSIS

int MGOseluwnetid (Uwnetid **lst, Uwnetid *uwn)

DESCRIPTION

The MGOseluwnetid() function selects uwnetid records. Information is passed through uwn and returned through the linked list lst. The selection criteria fields are:

• uwn.uwnetid
• uwn.uid
• uwn.luid
• uwn.account

uwn.uwnetid is the uwnetid name. uwn.uid is the (high) uid value. uwn.luid is the (low) uid value. uwn.account is the account name. It typically is set to the encrypted employee number, student number, or some other unique value. Any of the above may be specified in any combination. The following fields are set for each selected uwnetid:

• lst.next
• lst.uwnetid
• lst.uwnetid_uuid
• lst.uid
• lst.luid
• lst.account
• lst.disenfran
• lst.comment
• lst.status_name
• lst.status_code

Note: A value of '-2' for either the uid or luid indicates no value has been assigned.

RETURN VALUE

Returns the number of records selected upon success or -1 if an error occurred (in which case MGOerrno and MGOerrmsg are set appropriately).

ERRORS

• MGO_E_MAR - One or more of the required arguments were missing
• MGO_E_IAR - Invalid or ambiguous argument
• MGO_E_PMD - Permission denied. See access control
• MGO_E_MAT - No matches found
• MGO_E_SQL - An SQL error occurred. See MGOerrmsg for details

AUTHENTICATION LEVEL

rmango

SEE ALSO

MGOdeluwnetid(), MGOfreeuwnetid(), MGOinsuwnetid(), MGOupduwnetid(), MGOzero()