libgadu 1.10.1
|
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. |
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
.
anonymous enum |
anonymous enum |
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ę.
sess | Struktura sesji |
type | Rodzaj zapytania |
request | Treść zapytania (może być równe NULL) |