[id] = OpenConnection(id, server$, port[, table])

Sobald die Verbindung erfolgreich hergestellt wurde, können Sie die Befehle SendData() und ReceiveData() verwenden, um mit dem Server zu kommunizieren. Wenn Sie fertig sind, sollten Sie den Befehl CloseConnection() aufrufen, um die Verbindung zum Server zu trennen.

Bitte beachten Sie, dass Schemapräfixe wie "http://" oder "ftp://" nicht Teil eines Servernamens sind. Diese geben nur das Protokoll an, das für die Kommunikation mit dem Server verwendet wird. Wenn Sie also eine Verbindung mit http://www.airsoftsoftwair.de erstellen wollen, müssen Sie als Servername "www.airsoftsoftwair.de" und Port 80 als Portnummer angeben, da 80 der Standard-HTTP-Port ist. Siehe unten für ein Beispiel. Eine Ausnahme von dieser Regel kann der Fall sein, wenn Sie den Tag Adapter verwenden, um mit einem Netzwerkadapter die Verbindung herzustellen. In diesem Fall werden Sie möglicherweise vom Netzwerkadapter aufgefordert, einen Schemanamen wie "http://" oder "ftp://" anzugeben. Dieser hängt jedoch wirklich vom Netzwerkadapter ab. Der integrierte Adapter von Hollywood unterstützt keine Schemapräfixe und erwartet, dass Sie die IP-Adresse oder den Hostnamen direkt angeben.

Ab Hollywood 8.0 akzeptiert OpenConnection() ein optionales Tabellenargument table, mit dem weitere Optionen angegeben werden können. Die folgenden Tags werden derzeit vom optionalen Tabellenargument erkannt:

Protocol:

Mit diesem Tag kann das Internetprotokoll angegeben werden, das beim Öffnen der Verbindung verwendet werden soll. Dies kann eine der folgenden speziellen Konstanten sein:

#IPV4:

Verwendet die Internetprotokollversion 4 (IPv4). IPv4-Adressen sind auf 32 Bit beschränkt und werden unter Verwendung von vier durch drei Punkte getrennten Zahlen dargestellt, z.B. 127.0.0.1.

#IPV6:

Verwendet die Internetprotokollversion 6 (IPv6). IPv6-Adressen verwenden 128 Bits und werden durch acht Gruppen von vier Hexadezimalziffern dargestellt, z.B. 2001:0db8:85a3:0000:0000:8a2e:0370:7334. Beachten Sie, dass #IPV6 auf AmigaOS und kompatiblen Systemen derzeit nicht unterstützt wird.

#IPAUTO:

Lassen Sie das Host-Betriebssystem das zu verwendende Internetprotokoll bestimmen. Sie können dann GetConnectionProtocol() verwenden, um herauszufinden, welches Internetprotokoll das Host-Betriebssystem für diesen Server ausgewählt hat. Siehe GetConnectionProtocol für Details.

Der Tag Protocol verwendet standardmäßig den Standardprotokolltyp, der mit SetNetworkProtocol() festgelegt wird. Standardmäßig ist dies aus historischen Gründen und aus Gründen der Portabilität #IPV4. Siehe SetNetworkProtocol für Details. (V8.0)

Adapter:

Mit diesem Tag können Sie einen oder mehrere Netzwerkadapter angeben, die zum Herstellen der angegebenen Verbindung benutzt werden sollten. Dies muss auf eine Zeichenkette gesetzt werden, die den Namen eines oder mehrerer Adapter enthält. Standardmäßig wird der mit SetDefaultAdapter() eingestellte Adapter verwendet. Siehe Lade- und Adaptermodule für Details. (V8.0)

SSL:

Setzen Sie diesen Tag auf True, um eine Verbindung über TLS/SSL-Verschlüsselung anzufordern. Beachten Sie, dass die Einstellung dieses Tags bei Verwendung des integrierten Netzwerkadapters von Hollywood keine Auswirkungen hat, da dieser keine TLS/SSL-Verbindungen unterstützt. Möglicherweise gibt es jedoch einen Netzwerkadapter, der von einem Plugin bereitgestellt wird, das TLS/SSL unterstützt. Wenn Sie diesen Tag auf True setzen, leitet Hollywood Ihren Wunsch nach einer TLS/SSL-Verbindung an den Netzwerkadapter weiter, der vom Plugin bereitgestellt wird. (V8.0)

UserTags:

Dieser Tag kann verwendet werden, um zusätzliche Daten anzugeben, die an Datei- und Netzwerkdapter übergeben werden sollen. Wenn Sie diesen Tag verwenden, müssen Sie ihn auf eine Tabelle mit Schlüssel-Wert-Paaren setzen, die die zusätzlichen Daten enthalten, die an Plugins übergeben werden sollen. Siehe Benutzer-Tags für Details. (V10.0)

id

Identifikator für die neue Verbindung oder Nil für die automatische ID-Auswahl

server$

Server, mit dem Sie sich verbinden wollen

port

Portnummer für die Verbindung

table

optional: Tabellenargument mit weiteren Optionen (siehe oben) (V8.0)

id

optional: Identifikator der Verbindung; wird nur zurückgegeben werden, wenn Sie Nil als id angegeben haben (siehe oben)

OpenConnection(1, "www.airsoftsoftwair.de", 80)
SendData(1, "GET http://www.airsoftsoftwair.de/index.html " ..
            "HTTP/1.0\r\n\r\n")
a$ = ReceiveData(1, #RECEIVEALL)
Print(a$)
CloseConnection(1)