Node:get-uconf-stat, Next:, Previous:set-last-read, Up:Protocol Requests



get-uconf-stat [78] (8) Recommended


        get-uconf-stat [78] ( conference : Conf-No )
                -> ( UConference );

This call returns some information about conference conference. The information it returns is sufficient for most uses of conference information, and this call should be used instead of get-conf-stat wherever possible. It uses less bandwidth and the lyskomd server always keeps all UConference objects in memory, so this call is significantly faster than get-conf-stat.

This is also currently the only way to get all the flag bits of the conference.

Example:

        1 50 6
        =1 8HTestconf 0000 1 34 21 17 6 97 4 197 1
           37 3 22 18 6 97 5 198 1 5 4 5 0 5 0 77 4 1 6
        2 78 6
        =2 8HTestconf 00001000 6 77
        3 50 7
        =3 11HDavid Byers 1111 13 4 19 18 6 97 5 198 1
           13 4 19 18 6 97 5 198 1 7 0 7 0 0 0 77 1 1 0
        4 78 7
        =4 11HDavid Byers 11111000 0 77

This example shows the difference between get-conf-stat-old and get-uconf-stat. In the first two examples conference 6 is retrieved, and in the second two, conference 7, which happens to be a person, is retrieved. Note the difference in length of the flag field.

Error codes

undefined-conference
The conference conference does not exist or is secret.
conference-zero
conference is zero.