HttpClose

obj -> HttpClose(int1[, handle2]) : int

HTTP-Objekt schließen

Details

• obj: Deskriptor des HTTP -Objekts
• int1:
  • Optionen::
  • _HttpDiscard
  • _HttpCloseConnection
  • _HttpParamsToURI
  • _HttpParamsToData
  • _HttpSkipChunked
  • _HttpUseWebProxy
  • _HttpUseWebProxyTLS
• handle2: Deskriptor auf HTTP-Body
• Resultat: int Fehlerwert
• Siehe: Verwandte Befehle , Http , HttpOpen () , Beispiel

Dieser Befehl schließt das Objekt (obj) und leert die Header- und Parameter-Liste. Alle Objekte, die in den Listen enthalten sind, werden gelöscht.

Bei den Typen _HttpRecvRequest und _HttpRecvResponse werden eventuell noch ausstehende Daten des HTTP-Body eingelesen und verworfen. Dazu muss der Header über einen Content-Length-Eintrag verfügen.

Bei den Typen _HttpSendRequest und _HttpSendResponse wird die Anfrage bzw. die Antwort über den bei HttpOpen () angegebenen Socket versendet. Als HTTP-Body kann der Inhalt einer externen Datei, der Inhalt eines Memory -Objekts oder die Parameter-Liste gesendet werden. Der Deskriptor der externen Datei oder des Memory -Objekts wird in (handle2) übergeben. In (int1) können eine oder mehrere der folgenden Optionen angegeben werden:

• _HttpDiscard Die Daten werden nicht versendet.
• _HttpCloseConnection Im HTTP-Header wird der Eintrag Connection: close vorgenommen, der bei HTTP/1.1 dem Empfänger signalisiert, dass die Verbindung nach dem Erhalt der HTTP-Response geschlossen werden soll.
• _HttpParamsToURI Der Inhalt der Parameter-Liste wird in die URI eingefügt. Diese Option ist nur beim Typ _HttpSendRequest möglich.
• _HttpParamsToData Der Inhalt der Parameter-Liste wird als HTTP-Body aufbereitet. In (handle2) darf kein Deskriptor angegeben werden.
• _HttpSkipChunked Auf dem Socket vorhandene und noch nicht gelesene Chunked-Daten werden überlesen. Die Option wird nur bei _HttpRecvRequest und _HttpRecvResponse ausgewertet.
• _HttpUseWebProxy / _HttpUseWebProxyTLS Falls das Senden über einen HTTP-Proxy (_HttpUseWebProxy) bzw. HTTPS-Proxy (_HttpUseWebProxyTLS) erfolgt, muss eine dieser Option verwendet werden. Dadurch wird ein modifizierter HTTP-Header verwendet. Die Eigenschaft ProxyAuthorization ist ebenfalls nur bei diesen Optionen wirksam.

Der Rückgabewert ist der _ErrOk, wenn der Versand erfolgreich war. Zu den möglichen Fehlerwerten gehören Socket-Fehler und _ErrFsiReadFault, wenn die Datei in (handle2) nicht vollständig gelesen werden kann.

Bei _HttpSendRequest werden die folgenden Header-Einträge automatisch gesetzt, wenn sie nicht bereits per Prozedur definiert wurden:

• Host: (falls HostName definiert ist)
• Date:
• User-Agent:

Bei _HttpSendResponse werden die folgenden Header-Einträge automatisch gesetzt, wenn sie nicht bereits per Prozedur definiert wurden:

• Date:
• Server:

Der Header-Eintrag Content-Length: wird automatisch gesetzt, wenn ein HTTP-Body vorhanden ist. Der angegebene Deskriptor muss, sofern er nicht weiter benötigt wird, entfernt werden (siehe MemFree () bzw. FsiClose ()).

Mögliche Laufzeitfehler:

• _ErrHdlInvalid: Der in (obj) oder in (handle2) übergebene Deskriptor ist ungültig.
• _ErrStringOverflow: Bei der Option _HttpParamsToURI wird die URI länger als 8192 Bytes oder die vom Server gelieferte Challenge ist länger als 4096 Byte (bei Verwendung von _HttpProxyAuthTypeNTLM .