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



add-member [100] (10) Recommended


        add-member [100] (( conf-no  : Conf-No;
                            pers-no  : Pers-No;
                            priority : INT8;
                            where    : INT16;
                            type     : Membership-Type ))
                -> ( );

Make the person pers-no a member of conference conf-no. The membership priority is set to priority and its position in the membership list is set to where.

The membership flags are set to type. If the current user is adding a user he isn't supervisor of, the invitation bit of type is automatically set by the server.

This call can be used to change the priority, position and flags of a conference in the person's membership list if the person is already a member of the conference. The person doing this must either be a supervisor of the affected person, or have sufficient privileges enabled.

Example:

        1 99 119 0 10 0
        =1 1 { 49 14 17 13 8 91 5 255 1 119 255 0 0 * 119 00001111 }
        1 100 1 119 250 0 10000000
        =1
        1 100 119 119 251 1 00000000
        =1
        1 99 119 0 10 0
        =1 2 { 52 30 14 11 5 96 2 162 1 1 250 0 0 * 119 00000000
               49 14 17 13 8 91 5 251 1 119 255 0 0 * 10000000 }

This example makes person 119 (me) a member of conference number 1 and changes the priority and some flags of the preexisting membership in conference 119. The priority is set to 250 and the conference is placed first in the membership list. The first and last calls of the example show the membership list for person 119 before and after the calls.

Error codes

login-first
Login required before issuing this call.
undefined-conference
Conference conf-no does not exist or is secret.
conference-zero
conf-no is zero.
undefined-person
Person pers-no does not exist
access-denied
Not enough permissions or privileges to add members to conf-no or to change privileges, position or type of a preexisting membership.
permission-denied
Person pers-no is already a member of conference conf-no, but the person logged on is not a supervisor and does not have enough privileges to change the priorities of person pers-no.