SYNOPSIS
int MGOgetuwnetids (Uwnetid **lst, Validation *val)
DESCRIPTION
The MGOgetuwnetids() function returns a list of uwnetid records
affiliated with the given validation search criteria.
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.uwnetid (r)
- val.validid (r)
- val.ein (r) [1]
- val.ssn (r)
- val.studentid (r) [1, 2, 7]
- val.account (r) [4]
- val.system_key (r) [2]
- val.clinicianid (r) [3]
- val.advanceid (r) [7]
- val.regid (r)
- val.lname (o)
- val.source_code (o)
- val.status_code (o)
val.uwnetid is the uwnet id.
val.validid is the validation id.
val.ein is the employee number. val.ssn is the social security
number. val.studentid is the student number. val.account is
the AVF account name. val.system_key is the student system key value.
val.clinicianid is the clinician id.
val.advanceid is the advance id.
val.regid is the registry id.
val.lname is the last name.
Wildcarding is supported by placing a "%" to represent zero
or more characters, or a "_" to represent a single, non-blank character.
val.source_code is the validation source reference code.
val.status_code is the validation status reference code.
You must specify either a uwnetid, or one (or more) of validid, ein, ssn, studentid,
account, system_key, clinicianid, advanceid, regid.
The following fields are set for each matched uwnetid:
- lst.next
- lst.uwnetid
- lst.uwnetid_uuid
- lst.uid
- lst.luid
- lst.account
- lst.disenfran
- lst.comment
- lst.instance
- 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_VNV - The given validation information is not valid
- MGO_E_MAT - No uwnetids affiliated with given validation information
- MGO_E_SQL - An SQL error occurred. See MGOerrmsg for details
AUTHENTICATION LEVEL
rmango
SEE ALSO
MGOfreeuwnetid(),
MGOselrvalsource(),
MGOselrvalstatus(),
MGOzero()