Katalog publiczny
[Połączenie z serwerem]

Opis szczegółowy

Funkcje katalogu publicznego pozwalają wyszukiwać znajomych oraz manipulować informacjami o sobie (imię, nazwisko, miejscowość, rok urodzenia itd.). Każda operacja na katalogu publicznym wymaga skonstruowania odpowiedniego zapytania do serwera i ewentualnej obsłudze odpowiedzi.

Wyszukiwanie może wyglądać następująco:

gg_pubdir50_t zapytanie;

zapytanie = gg_pubdir50_new(GG_PUBDIR50_SEARCH_REQUEST);

if (!zapytanie)
    błąd("Brak pamięci");

// Jeśli szukamy danego numeru...

gg_pubdir50_add(zapytanie, GG_PUBDIR50_UIN, "123456");

// ...lub kobiet o imieniu Anna...

gg_pubdir50_add(zapytanie, GG_PUBDIR50_FIRSTNAME, "Anna");
gg_pubdir50_add(zapytanie, GG_PUBDIR50_GENDER, GG_PUBDIR50_GENDER_FEMALE);

// ...lub osób urodzonych w latach 1979-1985, aktualnie dostępnych...

gg_pubdir50_add(zapytanie, GG_PUBDIR50_BIRTHYEAR, "1979 1985");
gg_pubdir50_add(zapytanie, GG_PUBDIR50_START, "0");
gg_pubdir50_add(zapytanie, GG_PUBDIR50_ACTIVE, GG_PUBDIR50_ACTIVE_TRUE);

// ...to po ustaleniu parametrów wywołujemy

gg_pubdir50(sesja, zapytanie);

// Po przetworzeniu wyników zwalniamy pamięć

gg_pubdir50_free(zapytanie);

Jak widać, gg_pubdir50_new() tworzy obiekt opisujący operację katalogu, gg_pubdir50_add() dodaje kolejne pola zapytania. Pole zapytania jest w rzeczywiści stałą tekstową, np. GG_PUBDIR50_UIN to "FmNumber". Należy pamiętać, że wszystkie argumenty są tekstami, ale nie trzeba się przejmować alokacją pamięci — biblioteka zapamięta to, co jest potrzebne. Teksty muszą być oczywiście kodowane w CP1250. Na końcu wywołujemy funkcję gg_pubdir50(), która zwróci numer sekwencyjny wyszukiwania (można zachować dla późniejszego rozróżnienia wyników).

Aby otrzymać wynik, należy obsłużyć zdarzenia GG_EVENT_PUBDIR50_SEARCH_REPLY, GG_EVENT_PUBDIR50_WRITE i GG_EVENT_PUBDIR50_READ. Dla przykładu, obsługa wyników wyszukiwania wygląda następująco:

gg_pubdir50_t wynik;
int i, ilosc;

wynik = event->event.pubdir50;
ilosc = gg_pubdir50_count(wynik);

if (ilosc < 1) {
    wiadomość("Nie znaleziono");
    return;
}

for (i = 0; i < ilosc; i++) {
    const char *numer, *imie, *pk./usr/share/doc/libgadu-dev/api/group__proxy.html0000644000000000000000000001725611476667070021000 0ustar  rootroot

libgadu: Serwer pośredniczący








Serwer pośredniczący


[Pozostałe funkcje]

Opis szczegółowy

Biblioteka libgadu obsługuje wykonywanie połączeń za pomocą serwerów pośredniczących HTTP. Możliwe jest użycie serwerów wymagających autoryzacji mechanizmem podstawowym (Digest i NTLM nie są obsługiwane). Aby wymusić korzystanie z serwera pośredniczącego, należy ustawić flagę gg_proxy_enabled i odpowiednio ustawić poszczególne zmienne.


Błąd:
Serwer pośredniczący nie jest wykorzystywany dla połączeń bezpośrednich.


Błąd:
Ustawienia serwera pośredniczącego są globalne dla wszystkich połączeń.










Zmienne


int gg_proxy_enabled = 0



 Flaga włączenia połączeń przez serwer pośredniczący.  


char * gg_proxy_host = NULL



 Adres serwera pośredniczącego.  


int gg_proxy_port = 0



 Port serwera pośredniczącego.  


int gg_proxy_http_only = 0



 Flaga używania serwera pośredniczącego jedynie dla usług HTTP.  


char * gg_proxy_username = NULL



 Nazwa użytkownika do autoryzacji serwera pośredniczącego.  


char * gg_proxy_password = NULL



 Hasło użytkownika do autoryzacji serwera pośredniczącego.  




Dokumentacja zmiennych






      

        

          int gg_proxy_enabled = 0          
        

      








Flaga włączenia połączeń przez serwer pośredniczący. 












      

        

          char* gg_proxy_host = NULL          
        

      








Adres serwera pośredniczącego. 












      

        

          int gg_proxy_port = 0          
        

      








Port serwera pośredniczącego. 












      

        

          int gg_proxy_http_only = 0          
        

      








Flaga używania serwera pośredniczącego jedynie dla usług HTTP. 












      

        

          char* gg_proxy_username = NULL          
        

      








Nazwa użytkownika do autoryzacji serwera pośredniczącego. 












      

        

          char* gg_proxy_password = NULL          
        

      








Hasło użytkownika do autoryzacji serwera pośredniczącego. 










Wygenerowano Sun Dec 5 10:49:28 2010 dla libgadu programem 

doxygen 1.5.6 



./usr/share/doc/libgadu-dev/api/group__pubdir50.html0000644000000000000000000012717411476667070021252 0ustar  rootroot

libgadu: Katalog publiczny








Katalog publiczny


[Połączenie z serwerem]

Opis szczegółowy

Funkcje katalogu publicznego pozwalają wyszukiwać znajomych oraz manipulować informacjami o sobie (imię, nazwisko, miejscowość, rok urodzenia itd.). Każda operacja na katalogu publicznym wymaga skonstruowania odpowiedniego zapytania do serwera i ewentualnej obsłudze odpowiedzi.

Wyszukiwanie może wyglądać następująco:


gg_pubdir50_t zapytanie;

zapytanie = gg_pubdir50_new(GG_PUBDIR50_SEARCH_REQUEST);

if (!zapytanie)
    błąd("Brak pamięci");

// Jeśli szukamy danego numeru...

gg_pubdir50_add(zapytanie, GG_PUBDIR50_UIN, "123456");

// ...lub kobiet o imieniu Anna...

gg_pubdir50_add(zapytanie, GG_PUBDIR50_FIRSTNAME, "Anna");
gg_pubdir50_add(zapytanie, GG_PUBDIR50_GENDER, GG_PUBDIR50_GENDER_FEMALE);

// ...lub osób urodzonych w latach 1979-1985, aktualnie dostępnych...

gg_pubdir50_add(zapytanie, GG_PUBDIR50_BIRTHYEAR, "1979 1985");
gg_pubdir50_add(zapytanie, GG_PUBDIR50_START, "0");
gg_pubdir50_add(zapytanie, GG_PUBDIR50_ACTIVE, GG_PUBDIR50_ACTIVE_TRUE);

// ...to po ustaleniu parametrów wywołujemy

gg_pubdir50(sesja, zapytanie);

// Po przetworzeniu wyników zwalniamy pamięć

gg_pubdir50_free(zapytanie);


Jak widać, gg_pubdir50_new() tworzy obiekt opisujący operację katalogu, gg_pubdir50_add() dodaje kolejne pola zapytania. Pole zapytania jest w rzeczywiści stałą tekstową, np. GG_PUBDIR50_UIN to "FmNumber". Należy pamiętać, że wszystkie argumenty są tekstami, ale nie trzeba się przejmować alokacją pamięci — biblioteka zapamięta to, co jest potrzebne. Teksty muszą być oczywiście kodowane w CP1250. Na końcu wywołujemy funkcję gg_pubdir50(), która zwróci numer sekwencyjny wyszukiwania (można zachować dla późniejszego rozróżnienia wyników).

Aby otrzymać wynik, należy obsłużyć zdarzenia GG_EVENT_PUBDIR50_SEARCH_REPLY, GG_EVENT_PUBDIR50_WRITE i GG_EVENT_PUBDIR50_READ. Dla przykładu, obsługa wyników wyszukiwania wygląda następująco:


gg_pubdir50_t wynik;
int i, ilosc;

wynik = event->event.pubdir50;
ilosc = gg_pubdir50_count(wynik);

if (ilosc < 1) {
    wiadomość("Nie znaleziono");
    return;
}

for (i = 0; i < ilosc; i++) {
    const char *numer, *imie, *pk./usr/share/doc/libgadu-dev/api/group__proxy.html0000644000000000000000000001725611476667070021000 0ustar  rootroot

libgadu: Serwer pośredniczący








Serwer pośredniczący


[Pozostałe funkcje]

Opis szczegółowy

Biblioteka libgadu obsługuje wykonywanie połączeń za pomocą serwerów pośredniczących HTTP. Możliwe jest użycie serwerów wymagających autoryzacji mechanizmem podstawowym (Digest i NTLM nie są obsługiwane). Aby wymusić korzystanie z serwera pośredniczącego, należy ustawić flagę gg_proxy_enabled i odpowiednio ustawić poszczególne zmienne.


Błąd:
Serwer pośredniczący nie jest wykorzystywany dla połączeń bezpośrednich.


Błąd:
Ustawienia serwera pośredniczącego są globalne dla wszystkich połączeń.










Zmienne


int gg_proxy_enabled = 0



 Flaga włączenia połączeń przez serwer pośredniczący.  


char * gg_proxy_host = NULL



 Adres serwera pośredniczącego.  


int gg_proxy_port = 0



 Port serwera pośredniczącego.  


int gg_proxy_http_only = 0



 Flaga używania serwera pośredniczącego jedynie dla usług HTTP.  


char * gg_proxy_username = NULL



 Nazwa użytkownika do autoryzacji serwera pośredniczącego.  


char * gg_proxy_password = NULL



 Hasło użytkownika do autoryzacji serwera pośredniczącego.  




Dokumentacja zmiennych






      

        

          int gg_proxy_enabled = 0          
        

      








Flaga włączenia połączeń przez serwer pośredniczący. 












      

        

          char* gg_proxy_host = NULL          
        

      








Adres serwera pośredniczącego. 












      

        

          int gg_proxy_port = 0          
        

      








Port serwera pośredniczącego. 












      

        

          int gg_proxy_http_only = 0          
        

      








Flaga używania serwera pośredniczącego jedynie dla usług HTTP. 












      

        

          char* gg_proxy_username = NULL          
        

      








Nazwa użytkownika do autoryzacji serwera pośredniczącego. 












      

        

          char* gg_proxy_password = NULL          
        

      








Hasło użytkownika do autoryzacji serwera pośredniczącego. 










Wygenerowano Sun Dec 5 10:49:28 2010 dla libgadu programem 

doxygen 1.5.6 



./usr/share/doc/libgadu-dev/api/group__pubdir50.html0000644000000000000000000012717411476667070021252 0ustar  rootroot

libgadu: Katalog publiczny








Katalog publiczny


[Połączenie z serwerem]

Opis szczegółowy

Funkcje katalogu publicznego pozwalają wyszukiwać znajomych oraz manipulować informacjami o sobie (imię, nazwisko, miejscowość, rok urodzenia itd.). Każda operacja na katalogu publicznym wymaga skonstruowania odpowiedniego zapytania do serwera i ewentualnej obsłudze odpowiedzi.

Wyszukiwanie może wyglądać następująco:


gg_pubdir50_t zapytanie;

zapytanie = gg_pubdir50_new(GG_PUBDIR50_SEARCH_REQUEST);

if (!zapytanie)
    błąd("Brak pamięci");

// Jeśli szukamy danego numeru...

gg_pubdir50_add(zapytanie, GG_PUBDIR50_UIN, "123456");

// ...lub kobiet o imieniu Anna...

gg_pubdir50_add(zapytanie, GG_PUBDIR50_FIRSTNAME, "Anna");
gg_pubdir50_add(zapytanie, GG_PUBDIR50_GENDER, GG_PUBDIR50_GENDER_FEMALE);

// ...lub osób urodzonych w latach 1979-1985, aktualnie dostępnych...

gg_pubdir50_add(zapytanie, GG_PUBDIR50_BIRTHYEAR, "1979 1985");
gg_pubdir50_add(zapytanie, GG_PUBDIR50_START, "0");
gg_pubdir50_add(zapytanie, GG_PUBDIR50_ACTIVE, GG_PUBDIR50_ACTIVE_TRUE);

// ...to po ustaleniu parametrów wywołujemy

gg_pubdir50(sesja, zapytanie);

// Po przetworzeniu wyników zwalniamy pamięć

gg_pubdir50_free(zapytanie);


Jak widać, gg_pubdir50_new() tworzy obiekt opisujący operację katalogu, gg_pubdir50_add() dodaje kolejne pola zapytania. Pole zapytania jest w rzeczywiści stałą tekstową, np. GG_PUBDIR50_UIN to "FmNumber". Należy pamiętać, że wszystkie argumenty są tekstami, ale nie trzeba się przejmować alokacją pamięci — biblioteka zapamięta to, co jest potrzebne. Teksty muszą być oczywiście kodowane w CP1250. Na końcu wywołujemy funkcję gg_pubdir50(), która zwróci numer sekwencyjny wyszukiwania (można zachować dla późniejszego rozróżnienia wyników).

Aby otrzymać wynik, należy obsłużyć zdarzenia GG_EVENT_PUBDIR50_SEARCH_REPLY, GG_EVENT_PUBDIR50_WRITE i GG_EVENT_PUBDIR50_READ. Dla przykładu, obsługa wyników wyszukiwania wygląda następująco:


gg_pubdir50_t wynik;
int i, ilosc;

wynik = event->event.pubdir50;
ilosc = gg_pubdir50_count(wynik);

if (ilosc < 1) {
    wiadomość("Nie znaleziono");
    return;
}

for (i = 0; i < ilosc; i++) {
    const char *numer, *imie, *pk./usr/share/doc/libgadu-dev/api/group__proxy.html0000644000000000000000000001725611476667070021000 0ustar  rootroot

libgadu: Serwer pośredniczący








Serwer pośredniczący


[Pozostałe funkcje]

Opis szczegółowy

Biblioteka libgadu obsługuje wykonywanie połączeń za pomocą serwerów pośredniczących HTTP. Możliwe jest użycie serwerów wymagających autoryzacji mechanizmem podstawowym (Digest i NTLM nie są obsługiwane). Aby wymusić korzystanie z serwera pośredniczącego, należy ustawić flagę gg_proxy_enabled i odpowiednio ustawić poszczególne zmienne.


Błąd:
Serwer pośredniczący nie jest wykorzystywany dla połączeń bezpośrednich.


Błąd:
Ustawienia serwera pośredniczącego są globalne dla wszystkich połączeń.










Zmienne


int gg_proxy_enabled = 0



 Flaga włączenia połączeń przez serwer pośredniczący.  


char * gg_proxy_host = NULL



 Adres serwera pośredniczącego.  


int gg_proxy_port = 0



 Port serwera pośredniczącego.  


int gg_proxy_http_only = 0



 Flaga używania serwera pośredniczącego jedynie dla usług HTTP.  


char * gg_proxy_username = NULL



 Nazwa użytkownika do autoryzacji serwera pośredniczącego.  


char * gg_proxy_password = NULL



 Hasło użytkownika do autoryzacji serwera pośrednicząceg