SYNOPSIS
int MGOgetsponsors (Validation **lst, Validation *val)
DESCRIPTION
The MGOgetsponsos() function returns either a list of sponsors for a
given validation id, or a list of records for which a given sponsor is sponsoring.
Information is passed through val and returned through the linked list
lst. The selection criteria fields are:
- val.validid
- val.sponsid
- val.source_code
val.validid is the validation id. This is most likely the AVF account
name, as for now the only sponsored records are AVF.
val.sponsid is the sponsor's validation id.
val.source_code is the sponsor's source code.
Specify either a validid or a sponsid and source_code depending on which type
of search you wish to conduct.
The following fields are set for each matched validation. The values between
the brackets indicate these fields are set depending on the validation source
reference code (lst.source_code):
- lst.next
- lst.validid
- lst.sponsid
- lst.ein [1]
- lst.prior_ein [1]
- lst.ssn [1, 2, 3, 4, 7]
- lst.studentid [1, 2, 7]
- lst.account [4]
- lst.system_key [2]
- lst.advanceid [7]
- lst.regid
- lst.lname
- lst.fname
- lst.sec_lname [7]
- lst.sec_fname [7]
- lst.pac
- lst.pac_code
- lst.birthdate [1, 2, 3, 4, 7]
- lst.college [1, 2]
- lst.department [1, 2, 4]
- lst.unit [1]
- lst.hepps_type [1]
- lst.budget [1]
- lst.faccode [1]
- lst.mailstop [1]
- lst.sdb_class [2]
- lst.sdb_status [2]
- lst.employee_status [2]
- lst.expiration [4]
- lst.branch [2]
- lst.techfee [2]
- lst.alumni_member [7]
- lst.alumni_type [7]
- lst.comment_name [4]
- lst.comment_code [4]
- lst.category_name
- lst.category_code
- lst.source_name
- lst.source_code
- lst.status_name
- lst.status_code
RETURN VALUE
Returns the number of validations found 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 the selection criteria
- MGO_E_SQL - An SQL error occurred. See MGOerrmsg for details
AUTHENTICATION LEVEL
rmango
SEE ALSO
MGOfreevalidation(),
MGOselrvalsource(),
MGOzero()