Import i eksport listy kontaktów [Połączenie z serwerem]

Wyliczenia
enum	{   GG_USERLIST_PUT,   GG_USERLIST_GET }
	Rodzaj zapytania. Więcej...
enum	{   GG_USERLIST_PUT_REPLY,   GG_USERLIST_GET_REPLY }
	Rodzaj odpowiedzi. Więcej...
Funkcje
int	gg_userlist_request (struct gg_session *sess, char type, const char *request)
	Wysyła do serwera zapytanie dotyczące listy kontaktów.

---

Opis szczegółowy

Serwer pozwala przechowywać kompletną listę kontaktów w postaci tekstowej, by móc z niej korzystać na dowolnym komputerze bez konieczności ręcznego przenoszenia. Standardowo format listy kontaktów jest narzucony przez oryginalnego klienta (pola oddzielone średnikami), lecz serwer nie zwraca uwagi na treść i można przechowywać dowolne dane, dopóki nie będą one pobierane oryginalnym klientem.

Aby wysłać wyeksportować kontaktów, wywołujemy:

gg_userlist_request(sesja, GG_USERLIST_PUT, lista_kontatów);

W odpowiedzi dostaniemy od serwera zdarzenie GG_EVENT_USERLIST z polem type równym GG_USERLIST_PUT_REPLY.

Jeśli chcemy pobrać listę kontaktów z serwera, wywołujemy:

gg_userlist_request(sesja, GG_USERLIST_GET, NULL);

Oczekujemy zdarzenia GG_EVENT_USERLIST z type równym GG_USERLIST_GET_REPLY. Zawartość listy kontaktów znajdziemy w polu reply.

---

Dokumentacja typów wyliczanych

anonymous enum

Rodzaj zapytania.

Wartości wyliczeń:

GG_USERLIST_PUT	Eksport listy kontaktów.
GG_USERLIST_GET	Import listy kontaktów.

anonymous enum

Rodzaj odpowiedzi.

Wartości wyliczeń:

GG_USERLIST_PUT_REPLY	Wyeksportowano listy kontaktów.
GG_USERLIST_GET_REPLY	Zaimportowano listę kontaktów.

---

Dokumentacja funkcji

int gg_userlist_request	(	struct gg_session *	sess,
		char	type,
		const char *	request
	)

Wysyła do serwera zapytanie dotyczące listy kontaktów.

Funkcja służy do importu lub eksportu listy kontaktów do serwera. W odróżnieniu od funkcji gg_notify(), ta lista kontaktów jest przez serwer jedynie przechowywana i nie ma wpływu na połączenie. Format listy kontaktów jest ignorowany przez serwer, ale ze względu na kompatybilność z innymi klientami, należy przechowywać dane w tym samym formacie co oryginalny klient Gadu-Gadu.

Program nie musi się przejmować fragmentacją listy kontaktów wynikającą z protokołu -- wysyła i odbiera kompletną listę.

Parametry:

	sess	Struktura sesji
	type	Rodzaj zapytania
	request	Treść zapytania (może być równe NULL)

Zwraca:

0 jeśli się powiodło, -1 w przypadku błędu