SYNOPSIS
int MGOgetsubattributes (Subscription **lst, Subscription *sub)
DESCRIPTION
The MGOgetsubattributes() function gets a list of subscription attributes
for a uwnetid. Information is passed through sub and returned through
the linked list lst. The required fields are:
- sub.uwnetid
- sub.attribute_code
sub.uwnetid is the uwnetid name. sub.attribute_code is the
subscription attribute reference code. The following fields are set for each
matched subscription attribute:
- lst.uwnetid
- lst.subscription_code
- lst.subscription_name
- lst.attribute_code
- lst.attribute_name
- lst.attribute_data
Note: Only subscriptions which are subscribed-to will be included in the list.
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_MAT - No matches found given the selection criteria
- MGO_E_SQL - An SQL error occurred. See MGOerrmsg for details
AUTHENTICATION LEVEL
none
SEE ALSO
MGOfreesubscription(),
MGOselrsubattr(),
MGOzero()