SYNOPSIS

int MGOupduwnetid (Uwnetid *uwn)

DESCRIPTION

The MGOupduwnetid() function updates an existing uwnetid record. Information is passed through uwn. The required fields are:

• uwn.uwnetid
• uwn.new_uwnetid
• uwn.uid
• uwn.luid
• uwn.account
• uwn.disenfran
• uwn.comment
• uwn.status_code

uwn.uwnetid is the uwnetid name. uwn.new_uwnetid is the new uwnetid name, if you wish to change it. uwn.uid is the high uid value. Specify a positive value, or 0 to have one chosen at random. The same applies for a low uid (uwn.luid). uwn.account is the account name. It typically is set to the encrypted employee number, student number, or some other unique value. uwn.disenfran is a boolean indicating whether or not the uwnetid is disenfranchised. uwn.comment is a comment field. It can be used for any purpose (such as why this uwnetid was disenfranchised). uwn.status_code is the uwnetid status reference code. You can only change the new_uwnetid, uid, luid, account, disenfran, comment, and status_code fields. Specifying the new_uwnetid field effectively changes the uwnetid field.

RETURN VALUE

Returns the number of records updated 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_ICU - Invalid character found in new_uwnetid
• MGO_E_SQL - An SQL error occurred. See MGOerrmsg for details

AUTHENTICATION LEVEL

wmango

SEE ALSO

MGOdeluwnetid(), MGOinsuwnetid(), MGOselruwnstatus(), MGOseluwnetid(), MGOzero()