int MGOgetsubscriptions (Subscription **lst, Subscription *sub);
The MGOgetsubscriptions() function returns a list of subscriptions (implicit and explicit) for the given uwnetid. Information is passed through sub and returned through the linked list lst. The required and optional fields are:
sub.uwnetid is the uwnetid name. sub.subscription_code is the subscription reference code.
The following fields are set for each matched subscription. The values between the brackets indicate these fields are set depending on whether its an implicit or an explicit subscription (see note below).
Notes: lst.source_code is non-zero if it's an implicit subscription, and zero if it's an explicit subscription. Implicit subscriptions are inhereted by virtue of being affiliated with a particular validation, whereas explicit subscriptions are granted individually. The lst.status_code and lst.status_name fields are set as follows: For implicit subscriptions, this is the validation reference status; for explicit subscriptions, this is the subscription reference status.
Returns the number of subscriptions found upon success or -1 if an error occurred (in which case MGOerrno and MGOerrmsg are set appropriately).
rmango
MGOanalsubscription(), MGOfreesubscription(), MGOselrsubscription(), MGOselrsubstatus(), MGOselrvalstatus(), MGOzero()