HttpOpen

HttpOpen(int1, handle2) : handle

HTTP -Objekt erzeugen

Details

• int1:
  • Objekt-Typ:
  • _HttpSendRequest
  • _HttpRecvRequest
  • _HttpSendResponse
  • _HttpRecvResponse
• handle2: Deskriptor einer Socket-Verbindung
• Resultat: handle HTTP -Objekt oder Fehlerwert
• Siehe: Verwandte Befehle , HTTP , HttpClose () , Beispiel

Der Befehle erzeugt ein neues HTTP -Objekt vom Typ (int1). In (handle2) muss der Desktiptor der aktiven Socket-Verbindung (SckConnect ()) angegeben werden. Das Resultat ist entweder ein Fehlerwert oder der Deskriptor des neuen HTTP -Objekts. Für den Objekttyp gibt es vier Varianten, für die auch unterschiedliche Aktionen durchgeführt werden:

• _HttpSendRequest - Objekt zum Erstellen und Versenden einer Anfrage Das Objekt wird mit den Standardwerten für Method, URI und Protocol definiert. Die Listen für Header-Einträge und Parameter sind leer. Das Resultat ist _ErrOk.
• _HttpSendResponse - Objekt zum Erstellen und Versenden einer Antwort Das Objekt wird mit den Standardwerten für StatusCode und Protocol definiert. Die Listen für Header-Einträge und Parameter sind leer. Das Resultat ist _ErrOk.
• _HttpRecvRequest - Objekt zum Empfangen und Auswerten einer Anfrage Das Objekt wird angelegt und der komplette Request-Header über den Socket (handle2) in die Liste der Header-Einträge eingelesen. Falls die URI Parameter enthält, werden diese in die Parameterliste übertragen. Das Resulat ist _ErrOk, wenn ein gültiger HTTP-Header eingelesen werden konnte. Falls kein gültiger Header ermittelt werden konnte, ist das Resultat _ErrData. Als Resultat können auch Socket-Fehler zurückgeliefert werden, wenn beim Lesen der Header-Daten ein solcher Fehler auftritt.
• _HttpRecvResponse - Objekt zum Empfangen und Auswerten einer Antwort Das Objekt wird angelegt und der komplette Response-Header über den Socket (handle2) in die Liste der Header-Einträge eingelesen. Das Resulat ist _ErrOk, wenn ein gültiger HTTP-Header eingelesen werden konnte. Falls kein gültiger Header ermittelt werden konnte, ist das Resultat _ErrData. Als Resultat können auch Socket-Fehler zurückgeliefert werden, wenn beim Lesen der Header-Daten ein solcher Fehler auftritt.

Mögliche Laufzeitfehler:

• _ErrValueInvalid: Der in (int1) übergebene Wert ist nicht gültig.
• _ErrHdlInvalid: Der in (handle2) übergebene Deskriptor ist ungültig.