curl_easy_perform

Składnia

Argumenty

Argument	Opis
CURL* handle	Prawidłowy uchwyt do sesji CURL.

Zwracana wartość

Zwraca wartość CURLE_OK w przypadku gdy operacja zakończyła się sukcesem. Funkcja zwraca wartość różną od CURLE_OK w przypadku wystąpienia błędu.

W przypadku gdy nadano sesji opcję CURLOPT_ERRORBUFFER przy pomocy funkcji _{» curl ♦} curl_easy_setopt oraz wystąpił błąd to w buforze komunikatu błędu będzie dostępna treść błędu w postaci łańcucha znaków.

Opis szczegółowy

Funkcja wywołuje operację przesyłania pliku. Funkcję należy wywołać z uchwytem, który zwracany jest przez funkcję _{» curl ♦} curl_easy_init oraz po odpowiednim skonfigurowaniu utworzonej sesji przy pomocy funkcji _{» curl ♦} curl_easy_setopt.

Niniejsza funkcja wykona operacje przesyłania pliku jakie będą wynikały z konfiguracji sesji.

Uwaga! Niniejszej funkcji nie można wywoływać równolegle używając tego samego uchwytu. Funkcja umożliwia wielokrotne wykorzystywanie tego samego uchwytu pod warunkiem, że wywołania są sekwencyjne. Aby mieć możliwość przesyłania danych równolegle należy użyć kilku uchwytów sesyjnych CURL.

Dodatkowe informacje

Funkcję curl_easy_perform można wywoływać wielokrotnie dla tego samego uchwytu pod warunkiem, że wywołania będą sekwencyjne. Należy jednak pamiętać aby każdorazowo skonfigurować sesję przed wywołaniem curl_easy_perform przy pomocy funkcji _{» curl ♦} curl_easy_setopt.

Zagadnienia powiązane

CURLcode	Kody błędów zwracane przez funkcje biblioteki CURL. (typ wyliczeniowy)

Linki zewnętrzne

• http://curl.haxx.se/libcurl/c/curl_easy_perform.html