Cette fonction permet de se connecter à un serveur TCP/IP, en spécifiant des options de connexion.
Domaine d'application
Client Windows,
Serveur Windows,
Client Mobile,
Serveur Mobile,
Client Java,
Serveur Java,
Client Adélia Web,
Client Adélia Cloud.
Paramètres
ALPHA(n) |
Serveur |
Nom d'hôte ou adresse IP du serveur. |
||||||||||||
NUM_BIN_4 |
Port |
Numéro de port du serveur. |
||||||||||||
ALPHA(n) | Options |
Options. Liste de couples "option=valeur" séparés par des ';'. Les options possibles sont documentées plus loin.
|
||||||||||||
NUM_BIN_4 |
Socket |
Handle de la socket. |
||||||||||||
NUM_BIN_4 |
CodeRetour |
Code retour de l'opération : 0 L'opération s'est déroulée correctement Autre Code d'erreur spécifique |
* Attention le timeout de connexion ne peut pas excéder la valeur par défaut imposée au niveau système. En version Windows, si la connexion échoue en IPV4 par défaut, le runtime réessaie en IPV6. Le timeout effectif est donc égal à deux fois la valeur indiquée. De plus, le timeout ne s'applique qu'à la connexion. Un délai supplémentaire (non configurable) peut s'appliquer en cas d'échec d'une résolution de nom DNS.
Par exemple
ALPHA(128) Host
NUM_BIN_4 Port
ALPHA(128) Options
NUM_BIN_4 Socket
NUM_BIN_4 Rc
* Connexion avec un timeout de 5 secondes
Host = 'host.domain.com'
Port = 10000
Options = 'connect_timeout=5000'
APPELER_DLL 'VATOOLBX.DLL' 'VaToolBxSockConnectTcpServerEx' Host Port Options Socket Rc
SI Rc = 0
* connexion établie
...