Function DE Version 7.02

@HTTPSGet

Internet

Syntax

@HTTPSGet(SERVER1;PAGE2);
@HTTPSGet(SERVER1;PAGE2;PORT3);
@HTTPSGet(SERVER1;PAGE2;PORT3;FNTIMEOUT4);
@HTTPSGet(SERVER1;PAGE2;PORT3;FNTIMEOUT4;FNDATATYPERETURNFLAG5);
@HTTPSGet(SERVER1;PAGE2;PORT3;FNTIMEOUT4;FNDATATYPERETURNFLAG5;VSTACKPATHCUSTOMHEADER);
@HTTPSGet(SERVER1;PAGE2;PORT3;FNTIMEOUT4;FNDATATYPERETURNFLAG5;VSTACKPATHCUSTOMHEADER;FNRECEIVEBUFFERSIZE);
@HTTPSGet(SERVER1;PAGE2;PORT3;FNTIMEOUT4;FNDATATYPERETURNFLAG5;VSTACKPATHCUSTOMHEADER;FNRECEIVEBUFFERSIZE;FNOPTIONS);
@HTTPSGet(SERVER1;PAGE2;PORT3;FNTIMEOUT4;FNDATATYPERETURNFLAG5;VSTACKPATHCUSTOMHEADER;FNRECEIVEBUFFERSIZE;FNOPTIONS;TEXTHEADEREND);
@HTTPSGet(SERVER1;PAGE2;PORT3;FNTIMEOUT4;FNDATATYPERETURNFLAG5;VSTACKPATHCUSTOMHEADER;FNRECEIVEBUFFERSIZE;FNOPTIONS;TEXTHEADEREND;RETBINBSENDDATA);

Beschreibung

Derzeit nur für Windows verfügbar!!!

Liefert den HTML-Code einer WWW-Seite als TEXT zurück. Neben TEXT SERVER1 und TEXT PAGE2 kann optional eine Portnummer FN/TEXT PORT3 bestimmt werden. Ohne Angabe wird standardmäßig 443 (https) verwendet. FN FNTIMEOUT4 ist reserviert und wird im Moment nicht genutzt (es sollte 10 angegeben werden).

Eine Überprüfung der Server-Zertifikate findet noch nicht statt.

Optional FNDATATYPERETURNFLAG5:
0=TEXT (default)
1=RT
2=BINBUFFER

Optional VSTACKPATHCUSTOMHEADER:
Wird hier ein VSTack-Path angegeben, werden die Text-Variablen auf dem VStack in Header-Felder für den Http-Request umgesetzt. Auch der "GET" Request muss dann auf dem VStack liegen!

Optional FNRECEIVEBUFFERSIZE:
Es kann die Größe des Empfangspuffers angegeben werden. Er kann niemals kleiner sein als 64514 Bytes (= default Größe), ein kleiner angegebener Wert wird automatisch entsprechend erhöht.

Optional FNOPTIONS:
Folgende Optionen gelten nur für den Fall, dass ein VSTACKPATHCUSTOMHEADER angegeben wurde!
1 = Am Ende des Datenblocks wird /r/n angefügt (default)
2 = Am Ende einer jeden TEXT-Variable wird ein /r/n angefügt (default)
4 = Am Ende des Datenblocks wird ein NULL-Char (0x00) angefügt
8 = Am Ende einer jeden TEXT-Variable wird ein /r/n angefügt, falls es nicht die letzte Variable auf dem Stack ist.
16= Wenn als die letzte 4 Bytes des zurletzt empfangenen Pakets die Zeichenfolge \r\n\r\n empfangen wurde, wird der Empfang als abgeschlossen betrachtet und die @Function kehrt zurück.

Optional TEXTHEADEREND:
Hier kann ein TEXT angegeben werden, das das Ende der Header-Zeilen signalisiert. bei einem Leerstring ("") wird die Angabe wird ignoriert (default).

Optional RETBINBSENDDATA:
Der gesendete Request wird hier als BINBUFFER zurückgegeben.

Beispiel: @HTTPSGet(SERVER1;PAGE2);

@HTTPSGet("www.slnetsolutions.de";"/");

Beispiel: @HTTPSGet(SERVER1;PAGE2;PORT3);

@HTTPSGet("www.slnetsolutions.de";"/";443);

Beispiel: @HTTPSGet(SERVER1;PAGE2;PORT3;FNTIMEOUT4);

@HTTPSGet("www.slnetsolutions.de";"/";443;15);

Timeout auf 15 Sekunden gesetzt.