Zmiana statusu użytkownika
[Połączenie z serwerem]


Opis szczegółowy

Domyślnym statusem użytkownika po połączeniu z serwerem jest GG_STATUS_AVAIL. Domyślny status połączenia można zmienić za pomocą pól status i status_descr struktury gg_login_params. Już po połączeniu z serwerem, status można zmieniać za pomocą poniższych funkcji.

Przykład zmiany stanu na zajęty z opisem, widoczny tylko dla znajomych:

gg_change_status_descr(sesja, GG_STATUS_INVISIBLE_DESCR | GG_STATUS_FRIENDS_MASK, "Nie przeszkadzać!");

Aby obserwować zmiany statusu kontaktów, należy najpierw dodać do listy konktaktów ich identyfikatory, a następnie obsługiwać zdarzenia związane ze zmianami statusu.

Błąd:
Nie ma możliwości ustawiania i poprawnego odbierania statusów zawierających czas powrotu.


Definicje

#define GG_STATUS_DESCR_MAXSIZE   70
 Maksymalna długośc opisu.

Wyliczenia

enum  {
  GG_STATUS_NOT_AVAIL,
  GG_STATUS_NOT_AVAIL_DESCR,
  GG_STATUS_AVAIL,
  GG_STATUS_AVAIL_DESCR,
  GG_STATUS_BUSY,
  GG_STATUS_BUSY_DESCR,
  GG_STATUS_INVISIBLE,
  GG_STATUS_INVISIBLE_DESCR,
  GG_STATUS_BLOCKED,
  GG_STATUS_FRIENDS_MASK
}
 Rodzaje statusów użytkownika. Więcej...

Funkcje

int gg_change_status (struct gg_session *sess, int status)
 Zmienia status użytkownika.
int gg_change_status_descr (struct gg_session *sess, int status, const char *descr)
 Zmienia status użytkownika na status opisowy.
int gg_change_status_descr_time (struct gg_session *sess, int status, const char *descr, int time)
 Zmienia status użytkownika na status opisowy z podanym czasem powrotu.


Dokumentacja definicji

#define GG_STATUS_DESCR_MAXSIZE   70

Maksymalna długośc opisu.


Dokumentacja typów wyliczanych

anonymous enum

Rodzaje statusów użytkownika.

Wartości wyliczeń:
GG_STATUS_NOT_AVAIL  Niedostępny.
GG_STATUS_NOT_AVAIL_DESCR  Niedostępny z opisem.
GG_STATUS_AVAIL  Dostępny.
GG_STATUS_AVAIL_DESCR  Dostępny z opisem.
GG_STATUS_BUSY  Zajęty.
GG_STATUS_BUSY_DESCR  Zajęty z opisem.
GG_STATUS_INVISIBLE  Niewidoczny (tylko własny status).
GG_STATUS_INVISIBLE_DESCR  Niewidoczny z opisem (tylko własny status).
GG_STATUS_BLOCKED  Zablokowany (tylko status innych).
GG_STATUS_FRIENDS_MASK  Flaga bitowa dostępności tylko dla znajomych.


Dokumentacja funkcji

int gg_change_status ( struct gg_session sess,
int  status 
)

Zmienia status użytkownika.

Parametry:
sess Struktura sesji
status Nowy status użytkownika
Zwraca:
0 jeśli się powiodło, -1 w przypadku błędu

int gg_change_status_descr ( struct gg_session sess,
int  status,
const char *  descr 
)

Zmienia status użytkownika na status opisowy.

Parametry:
sess Struktura sesji
status Nowy status użytkownika
descr Opis statusu użytkownika
Zwraca:
0 jeśli się powiodło, -1 w przypadku błędu

int gg_change_status_descr_time ( struct gg_session sess,
int  status,
const char *  descr,
int  time 
)

Zmienia status użytkownika na status opisowy z podanym czasem powrotu.

Parametry:
sess Struktura sesji
status Nowy status użytkownika
descr Opis statusu użytkownika
time Czas powrotu w postaci uniksowego znacznika czasu
Zwraca:
0 jeśli się powiodło, -1 w przypadku błędu


Wygenerowano Sun Dec 7 03:50:24 2008 dla libgadu programem  doxygen 1.5.6