OpenNetworkConnection()

Syntaxe

Resultat = OpenNetworkConnection(NomServeur$, Port [, Option [, TempsMax [, IPLocal$ [, PortLocal]]]])
Description
Ouvre une connexion réseau sur le serveur spécifié.

Arguments

NomServeur$ Le serveur.
Cela peut être une adresse IP ou un nom complet (ex: "127.0.0.1" ou "ftp.home.net").
Port Le port du serveur.
Option (optionnel) Peut être une des valeurs suivantes: 
  #PB_Network_TCP: La connexion utilisera le protocole réseau TCP (default)
  #PB_Network_UDP: La connexion utilisera le protocole réseau UDP. 
                   La connexion ne sera pas explicitement créée, car UDP est un protocole sans connexion, mais il faudra ajouter 
                   une entrée dans la pile de gestion PureBasic pour lui permettre d'envoyer des données via UDP en utilisant 
                   les fonctions régulières SendNetworkData() (et connexes) .
Combinée à l'une des valeurs suivantes (en utilisant le symbole | ): 
  #PB_Network_IPv4: Ouvre la connexion en utilisant IPv4 (par défaut).
  #PB_Network_IPv6: Ouvre la connexion en utilisant IPv6.
combiné avec l'une des valeurs suivantes (en utilisant l'opérande '|') : 
  #PB_Network_NoTLS : aucun chiffrement ne sera pris en charge pour cette connexion (par défaut)
  #PB_Network_TLSv1 : tous les protocoles TLS non obsolètes seront pris en charge (actuellement v1.2 et v1.3)
  #PB_Network_TLSv1_0 : le protocole TLS v1.0 sera pris en charge (attention, ce protocole est obsolète pour des raisons de sécurité)
  #PB_Network_TLSv1_1 : le protocole TLS v1.1 sera pris en charge (attention, ce protocole est obsolète pour des raisons de sécurité)
  #PB_Network_TLSv1_2 : le protocole TLS v1.2 sera pris en charge
  #PB_Network_TLSv1_3 : le protocole TLS v1.3 sera pris en charge
TempsMax (optionnel) Le temps maximal (en millisecondes) avant d'abandonner la tentative de connexion. Il ne devrait pas être réglé sur une valeur trop faible (inférieur à 5000 millisecondes), car l'initialisation d'une connexion sur le réseau peut prendre un certain temps.
IPLocal$ (optionnel) L'adresse IP locale liée à la connexion.
PortLocal (optionnel) Le port local lié à la connexion.
Par défaut, un port local aléatoire est automatiquement choisi pour la nouvelle connexion, mais il peut être remplacé par ce paramètre.

Valeur de retour

Renvoie un identifiant de connexion pour la connexion ouverte si la connexion a été établie correctement, zéro sinon.

Remarques

Pour prendre en charge le chiffrement TLS, UseNetworkTLS() doit être appelé avant cette commande et un indicateur TLS doit être spécifié.

Voir aussi

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

OS Supportés

Tous

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