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


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.


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.


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


Wygenerowano Sun Dec 5 02:36:10 2010 dla libgadu programem  doxygen 1.5.6