SYNOPSIS
int MGOgetmail (Subscription **lst, Subscription *sub)
DESCRIPTION
The MGOgetmail() function gets the mail forwarding address for a
uwnetid. Information is passed through sub and returned through the
linked list lst. The required fields are:
- sub.uwnetid
- sub.subscription_code
sub.uwnetid is the uwnetid name. sub.subscription_code is the
subscription reference code for the mail forwarding subscription. The
following fields are set for each matched subscription:
- lst.uwnetid
- lst.subscription_code
- lst.subscription_name
- lst.subscription_data
lst.subscription_data contains the mail forwarding address. An empty
field means that mail will not be forwarded.
RETURN VALUE
Returns 1 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_ISC - Invalid subscription code (not a mail forwarding subscription)
- MGO_E_SNP - Subscription is not permitted for uwnetid
- MGO_E_MAT - No match found given the selection criteria
- MGO_E_SQL - An SQL error occurred. See MGOerrmsg for details
AUTHENTICATION LEVEL
none
SEE ALSO
MGOfreesubscription(),
MGOselrsubscription(),
MGOsetmail(),
MGOzero()