SYNOPSIS

int MGOinsextcategory (Validation *cat)

DESCRIPTION

The MGOinsextcategory() function inserts a new extended category record. Information is passed through cat. The required fields are:

• cat.validid
• cat.source_code
• cat.category_code
• cat.status_code
• cat.expiration

cat.validid is the validation id. cat.source_code is the validation source reference code. This may be specified as "0" for a source-less binding. cat.category_code is the category reference code. cat.status_code is the validation status reference code. cat.expiration is the expiration date of the extended category.

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_VAL - No such validation source reference code
• MGO_E_VNV - The given validation information is not valid
• MGO_E_SQL - An SQL error occurred. See MGOerrmsg for details

AUTHENTICATION LEVEL

wmango

SEE ALSO

MGOdelextcategory(), MGOselextcategory(), MGOselrcategory(), MGOselrvalsource(), MGOselrvalstatus(), MGOzero()