Bezeichnung
easy:Close -- beendet einen libcurl-Easy-Handle
Übersicht
easy:Close()
Beschreibung
Dieser Befehl muss der letzte Befehl sein, die eine Easy-Sitzung aufruft. Er ist das Gegenteil von dem Befehl hurl.Easy() und muss mit dem gleichen Handle wie die Eingabe aufgerufen werden, der der Befehl hurl.Easy() zurück gibt.

Dies könnte alle Verbindungen schließen, die dieser handle verwendet hat und möglicherweise bis jetzt offen gehalten hat - es sei denn, er wurde während der Transfers an einem Multi-Handle gehängt. Rufen Sie diesen Befehl nicht auf, wenn Sie beabsichtigen, mehr Dateien zu übertragen. Die Wiederverwendung von Handles ist ein Schlüssel zu einer guten Leistung mit libcurl.

Gelegentlich können Sie Ihren Fortschritts- oder Header-Callback aus easy:Close() heraus aufrufen lassen (wenn Sie das zuvor mit easy:SetOpt() für den Handle eingestellt haben). So wie wenn libcurl beschließt, die Verbindung zu beenden und das Protokoll von einer Art ist, die eine Befehls-/Antwort-Sequenz erfordert, bevor die Verbindung getrennt wird. Beispiele für solche Protokolle sind FTP, POP3 und IMAP.

Jede Verwendung des Handles, nachdem dieser Befehl aufgerufen und zurückgegeben wurde, ist illegal. easy:Close() beendet den Handle und den gesamten damit verbundenen Speicher!

Eingaben
keine


Navigation zeigen