Node:get-unread-confs, Next:send-message, Previous:who-is-on, Up:Protocol Requests
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.
login-first
undefined-person
pers-no does not exist or is secret.