Node:get-unread-confs, Next:, Previous:who-is-on, Up:Protocol Requests



get-unread-confs [52] (1) Recommended


        get-unread-confs [52] ( pers-no : Pers-No )
                -> ( ARRAY Conf-No );

This call returns a list of conferences in which the person pers-no may have unread texts. This call will return a result for any valid pers-no. To retrieve information about secret persons, or to get information about unread texts in secret conference, the session must log on as a person with access to that information.

The result is guaranteed to include all conferences where pers-no has unread texts. It may also return some extra conferences. Passive memberships are never returned.

The returned conference numbers will be returned in the same order as they appear on the persons list of memberships.

Example:

        1 52 7
        =1 2 { 1 6 }
        1 52 1
        %1 10 0
        1 52 1000
        %1 10 0

This example shows how a session first retrieves the list of conferences in which person 7 has unread texts. The next request is for the unread conferences of person 1, but that happens to be a conference. The last request is for the unread conferences of person 1000, but that person didn't exist in the test database.

Error codes

login-first
Login required before issuing this call.
undefined-person
Person pers-no does not exist or is secret.