OpenNetworkConnection()

Syntax

Verbindung = OpenNetworkConnection(ServerName$, Port [, Flags [, TimeOut [, LokaleIP$ [, LokalerPort]]]])
Beschreibung
Öffnet eine Netzwerk-Verbindung zum angegebenen Server. Um TLS-Verschlüsselung zu unterstützen, muss UseNetworkTLS() vor diesem Befehl aufgerufen werden und es muss ein TLS-Flag gesetzt werden.

Parameter

ServerName$ Der Server, zu dem verbunden werden soll. Dies kann eine IP-Adresse oder ein voller Name sein (d.h. "127.0.0.1" oder "ftp.home.net").
Port Der Port des Servers, zu dem verbunden werden soll (siehe auch CreateNetworkServer()).
Flags (optional) Dies kann einer der folgenden Werte sein: 
  #PB_Network_TCP: Die Verbindung nutzt das TCP-Netzwerk-Protokoll (Standard).
  #PB_Network_UDP: Die Verbindung nutzt das UDP-Netzwerk-Protokoll. 
                   Die Verbindung wird nicht ausdrücklich erstellt, da UDP ein "verbindungsloses" Protokoll ist, aber es wird
                   einen Eintrag im "PureBasic Management Stack" hinzufügen und das Senden von
                   Daten über UDP mittels der regulären Befehle wie z.B. SendNetworkData() (und zugehörige) ermöglichen.
kombiniert (unter Verwendung des '|' Operanden) mit einem der folgenden Werte: 
  #PB_Network_IPv4: öffnet die Verbindung mittels IPv4 (Standard)
  #PB_Network_IPv6: öffnet die Verbindung mittels IPv6
kombiniert (unter Verwendung des '|' Operanden) mit einem der folgenden Werte: 
  #PB_Network_NoTLS  : für diesen Server wird keine Verschlüsselung genutzt (Standard)
  #PB_Network_TLSv1  : alle nicht veralteten TLS-Protokolle werden unterstützt (derzeit v1.2 und v1.3)
  #PB_Network_TLSv1_0: das TLS v1.0 Protokoll wird unterstützt (Achtung, dieses Protokoll ist aus Sicherheitsgründen veraltet)
  #PB_Network_TLSv1_1: das TLS v1.1 Protokoll wird unterstützt (Achtung, dieses Protokoll ist aus Sicherheitsgründen veraltet)
  #PB_Network_TLSv1_2: das TLS v1.2 Protokoll wird unterstützt
  #PB_Network_TLSv1_3: das TLS v1.3 Protokoll wird unterstützt
TimeOut (optional) Die maximale Zeit (in Millisekunden), bevor der Verbindungsversuch abgebrochen wird. Normalerweise sollte diese nicht auf einen zu niedrigen Wert (weniger als 5000 Millisekunden) gesetzt werden, da die Initialisierung einer Verbindung über das Netz einige Zeit dauern kann.
LokaleIP$ (optional) Die lokale IP-Adresse, an die die Verbindung gebunden werden soll.
LokalerPort (optional) Der lokale Port, an den die Verbindung gebunden werden soll. Standardmäßig wird automatisch ein zufälliger lokaler Port für die neue Verbindung gewählt, aber er kann mit diesem Parameter überschrieben werden.

Rückgabewert

Gibt den Verbindungs-Identifier für die geöffnete Verbindung zurück, wenn die Verbindung korrekt aufgebaut wurde. Wenn ein Fehler auftrat, ist das Ergebnis gleich Null.

Siehe auch

NetworkClientEvent(), SendNetworkData(), ReceiveNetworkData(), CloseNetworkConnection(), UseNetworkTLS()

Unterstützte OS

Alle

<- NextIPAddress() - Network Inhaltsverzeichnis - ReceiveNetworkData() ->