SYNOPSIS

int MGOselsuperuser (Admin **lst, Admin *adm)

DESCRIPTION

The MGOselsuperuser() function selects superuser records. Information is passed through adm and returned through the linked list lst. The selection criteria fields are:

• adm.principal

adm.principal is the principal name. If unspecified, all records are returned. The following fields are set for each selected superuser:

• lst.next
• lst.principal
• lst.comment

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

MGOdelsuperuser(), MGOfreeadmin(), MGOinssuperuser(), MGOupdsuperuser(), MGOzero()