SYNOPSIS

int MGOgetextcategories2 (Validation **lst, Validation *val)

DESCRIPTION

The MGOgetextcategories2() function returns a list of extended category records. Information is passed through val and returned through the linked list lst. The required and optional selection criteria fields are (the values in brackets indicate which validation tables are searched through when the field is specified):

• val.category_code (r)
• val.source_code (o)
• val.status_code (o)

val.category_code is the category reference code. val.source_code is the validation source reference code. val.status_code is the validation status reference code. You must specify the category_code. The following fields are set for each selected affiliation:

• lst.next
• lst.uwnetid
• lst.source_code
• lst.source_name
• lst.category_code
• lst.category_name
• lst.expiration
• lst.notify_code
• lst.notify_date
• lst.status_code

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_VAL - No such validation source reference code
• MGO_E_MAT - No matches found given selection criteria
• MGO_E_SQL - An SQL error occurred. See MGOerrmsg for details

AUTHENTICATION LEVEL

rmango

SEE ALSO

MGOinsextcategory(), MGOgetextcategory(), MGOfreevalidation(), MGOselrvalsource(), MGOzero()