DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Communication / Sockets
  • Re-création de socket
  • Réutilisation d'une adresse déjà utilisée
  • Permissions requises
  • Fonctionnalité d'application requise
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
Créé un socket. Un socket est une ressource de communication utilisée par les applications pour communiquer d'une machine à une autre sans se soucier du type de réseau.
Remarques :
  • Cette fonction doit être appelée sur le poste serveur utilisé pour la communication. Si le poste client utilise une application WINDEV pour se connecter à cet socket, cette application devra utiliser la fonction SocketConnecte.
  • Sockets SSL : Pour créer un socket de type SSL, utilisez la fonction SocketCréeSSL.
  • Sockets de type UDP : Pour créer un socket de type UDP, utilisez la fonction SocketCréeUDP.
SI SocketCrée("Serveur", 8000) = Faux ALORS
Erreur("erreur création " + ErreurInfo(errMessage))
FIN
Syntaxe
<Résultat> = SocketCrée(<Nom du socket> , <Numéro de port> [, <Adresse>])
<Résultat> : Booléen
  • Vrai si la fonction a réussi,
  • Faux dans le cas contraire. En cas d'erreur, il est possible de connaître le détail de l'erreur grâce à la fonction ErreurInfo.
<Nom du socket> : Chaîne de caractères
Nom à donner au socket. Ce nom sera utilisé dans toutes les fonctions socket. Attention : le nom du socket est "case-sensitive".
<Numéro de port> : Entier
Numéro de port à donner au socket. Ce numéro doit être compris entre 1 et 65000. Ce numéro sera indiqué lors de la connexion des postes client au poste serveur.
AndroidWidget AndroidiPhone/iPadWidget IOSMac Catalyst Il est nécessaire d'être "root" pour créer un socket sur un port inférieur ou égal à 1024 (être "root" signifie être l'utilisateur qui a toutes les permissions sur le système).
<Adresse> : Chaîne de caractères optionnelle
Adresse IP sur laquelle le socket doit être créé sur le poste en cours. Si le poste en cours est associé à plusieurs adresses IP (ou plusieurs cartes réseau), ce paramètre permet de choisir l'adresse IP à associer au socket.
Cette adresse IP peut être donnée sous la forme :
  • adresse IP au format XXX.XXX.XXX.XXX ( par exemple 125.5.110.100).
  • adresse IP contenant le nom du serveur (par exemple www.pcsoft.fr). Cette syntaxe est conseillée.
Remarques

Re-création de socket

Si un socket n'est pas fermé correctement par la fonction SocketFerme (re-démarrage du poste par exemple), la recréation du socket peut être relativement longue. Il est en effet nécessaire d'attendre que le système libère le socket.
iPhone/iPadWidget IOSMac Catalyst

Réutilisation d'une adresse déjà utilisée

Par défaut, la fonction SocketCrée permet de réutiliser une adresse déjà utilisée (par l'application elle-même ou par une autre application). Pour ne pas autoriser ce fonctionnement, il suffit de saisir le code suivant :
Socket.Option = SocketAdresseUnique
Remarque : Cette option permet donc également de savoir si une adresse ou un port est déjà utilisé. Dans ce cas, la fonction SocketCrée renvoie une erreur.
AndroidWidget Android

Permissions requises

L'utilisation de cette fonction entraîne la modification des permissions requises par l'application.
Permission requise : INTERNET
Cette permission autorise l'application à ouvrir des sockets réseau.
Universal Windows 10 App

Fonctionnalité d'application requise

L'utilisation de cette fonction entraîne la déclaration d'une fonctionnalité d'application dans l'assistant de génération de l'application.
Fonctionnalité requise : Réseaux domestiques et professionnels
Cette fonctionnalité permet aux applications d'utiliser des accès entrants et sortants vers des réseaux domestiques et professionnels.
Composante : wd290com.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 21/06/2023

Signaler une erreur ou faire une suggestion | Aide en ligne locale