Node:get-members, Next:, Previous:add-member, Up:Protocol Requests



get-members [101] (10) Recommended


        get-members [101] (( conf            : Conf-No;
                             first           : INT16;
                             no-of-members   : INT16 ))
                -> ( ARRAY Member );

This call returns a list of members of the conference conf. first is the first index in the membership to return, numbered from zero and up. no-of-members is the maximum number of members to return.

Some of the elements of the result may be cleared if the person requesting the information does not have sufficient privileges to see the contents. Cleared elements simply have all fields set to zero.

Example:

        1 101 1 0 100
        =1 4 { 7 7 00000000 8 8 00000000 9 8 00000000 
           10 10 00000000 }
        1 101 6 0 100
        =1 4 { 5 5 01000000 7 7 01000000 9 8 10000000 
           10 10 00000000 }
        1 101 6 2 2
        =1 2 { 9 8 10000000 10 10 00000000 }

In this example the client first requests the first 100 members in conference 1. The second request is for the first 100 members of conference 6. The last request is for members 2 and 3 in conference 6.

Error codes

undefined-conference
The conference conf does not exist or is secret.
index-out-of-range
first is higher than the number of members in conf.