SYNOPSIS

int MGOinsuwnetid (Uwnetid *uwn)

DESCRIPTION

The MGOinsuwnetid() function inserts a new uwnetid record. Information is passed through uwn. The required and optional fields are:

• uwn.uwnetid (r)
• uwn.uid (o)
• uwn.luid (o)
• uwn.account (o)
• uwn.disenfran (o)
• uwn.comment (o)
• uwn.status_code (o)

uwn.uwnetid is the new uwnetid name. If a high uid is wanted, then the uwn.uid field should be set. 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.

RETURN VALUE

Returns the number of records inserted 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_EXI - Record already exists
• MGO_E_ICU - Invalid character found in uwnetid
• MGO_E_SQL - An SQL error occurred. See MGOerrmsg for details

AUTHENTICATION LEVEL

wmango

SEE ALSO

MGOdeluwnetid(), MGOselruwnstatus(), MGOseluwnetid(), MGOupduwnetid(), MGOzero()