Übergeben Sie eine Callback-Funktion. Diese Funktion wird von
libcurl aufgerufen, nachdem eine Verbindung hergestellt oder
eine Verbindung wiederverwendet wurde (einschließlich SSL-Handshaking),
aber bevor eine Anfrage über die Verbindung gestellt wird. Bei
HTTP wird dieser Callback zum Beispiel aufgerufen, sobald eine
Verbindung zum Server hergestellt wurde, aber bevor eine GET/HEAD/POST/usw.-Anfrage
gesendet wurde.
Diese Funktion kann mehrere Male aufgerufen werden, wenn Umleitungen
aktiviert sind und verfolgt werden (siehe #CURLOPT_FOLLOWLOCATION).
Die Funktion wird wie folgt aufgerufen:
| | res = prereq(primary_ip, local_ip, primary_port, local_port[, data])
|
Hier finden Sie eine Beschreibung aller Parameter:
primary_ip-
Eine Zeichenkette, die die primäre IP des mit dieser Verbindung
aufgebauten Remote-Servers enthält. Bei FTP ist dies die IP
für die Kontrollverbindung. IPv6-Adressen werden ohne umgebende
Klammern dargestellt.
local_ip-
Eine Zeichenkette, die die Ursprungs-IP für diese Verbindung
enthält. IPv6-Adressen werden ohne umgebende Klammern dargestellt.
primary_port-
Die primäre Portnummer auf dem Remote-Server, der mit dieser
Verbindung hergestellt wird. Bei FTP ist dies der Port für die
Kontrollverbindung. Je nach Protokoll kann dies eine TCP- oder
eine UDP-Portnummer sein.
local_port-
Die Nummer des Ursprungsports für diese Verbindung. Je nach
Protokoll kann dies eine TCP- oder eine UDP-Portnummer sein.
data-
Wenn Sie das optionale Argument
userdata übergeben, wird der
Wert, den Sie in userdata übergeben, als dieser Parameter an
Ihre Callback-Funktion weitergegeben. Der Parameter userdata
kann von beliebigem Typ sein.
Die Callback-Funktion muss bei Erfolg #CURL_PREREQFUNC_OK zurückgeben
oder #CURL_PREREQFUNC_ABORT, damit die Übertragung fehlschlägt.