SYNOPSIS

int MGOselrcategory (Code **lst, Code *cod)

DESCRIPTION

The MGOselrcategory() function selects category reference records. Information is passed through cod and returned through the linked list lst. The selection criteria fields are:

• cod.code

cod.code is the category reference code. If unspecified, all records are returned. The following fields are set for each selected category:

• lst.next
• lst.code
• lst.name

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

none

SEE ALSO

MGOdelrcategory(), MGOfreecode(), MGOinsrcategory(), MGOupdrcategory(), MGOzero()