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