Node:get-membership-old, Next:get-created-texts, Previous:broadcast, Up:Protocol Requests
get-membership-old [46] (( person : Pers-No;
first : INT16;
no-of-confs : INT16;
want-read-texts : BOOL ))
-> ( ARRAY Membership-Old );
This call retrieves the membership record for a list of conferences for
a single person. person is the person whose memberships are to be
retrieved. first is the first position in the membership list to
retrieve, numbered from 0 and up. no-of-confs is the number of
membership records to retrieve. If want-read-texts is 0
the server will not send the contents of the read-texts array
of the memberships. (The size will be transmitted, but a single
asterisk (*) will be sent instead of the array itself.)
The server will return a membership list that is shorter than
no-of-confs if no-of-confs + first is larger than
the number of conferences the person is a member of.
Servers that support protocol version 10 will return a priority of zero if the passive bit in the membership record has been set (either by a set-membership-type or by setting the priority of the conference to zero.)
Example:
1 46 5 0 3 1
=1 2 { 49 14 17 13 8 91 5 255 1 5 255 0 0 *
20 14 22 17 6 97 4 197 1 6 100 2 0 * }
1 46 5 0 1 1
=1 1 { 49 14 17 13 8 91 5 255 1 5 255 0 0 * }
1 46 5 1 4 1
=1 1 { 20 14 22 17 6 97 4 197 1 6 100 2 0 * }
In this example we retrieve the memberships of person 5. The first call asks for three memberships, starting with number 0. Since this person is only a member of two conferences, the list returned only contains two memberships. (An extra newline has been inserted in the result of the first call to make the result more readable.) The next two calls retrieve a single membership each, the first by asking for only one, and the second by asking for four memberships, starting with number 1.
login-first
undefined-person
person does not exist.
undefined-conference
person does not exist or is secret.
index-out-of-range
first is higher than the index of the last conference in the
person's membership list.