Cette fonction permet de récupérer les adresses IP du poste.
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) [S] |
AdresseIP |
Adresse IP. |
NUM_BIN_2 [E] |
LgAdresseIP |
Longueur du buffer AdresseIP. |
NUM_BIN_2 [E/S] |
NumIP |
Numéro de l'adresse IP demandée. Remarque : passer la valeur 1 pour le premier appel.
En retour d'appel, NumIP contient la valeur d'un nouvel indice : 0 : pas d'autre adresse IP pour le poste. >0 : une autre adresse IP existe pour le poste ; il faut appeler à nouveau la fonction avec cet indice pour récupérer la valeur de cette autre adresse IP. |
NUM_BIN_4 [S] |
CodeRetour |
Code retour de l'opération : 0 : L'opération s'est déroulée correctement. -1 : Erreur lors de la détermination de l'hôte. -3 : Buffer AdresseIP trop petit. -4 : Indice NumIP invalide.
[Plate-forme C] > 0 : Erreur winsock.
[Plate-forme java] 1 : Erreur de sécurité. |
Remarques :
-
- L'adresse IP retournée peut être une adresse IPv4 ou IPv6.
Une adresse IPv4 est de la forme "w.x.y.z", où w, x, y et z sont compris entre 0 et 255.
Une adresse IPv6 est conforme à la représentation textuelle définie dans la norme RFC 2373 (8 positions entières de 32 bits, notation hexadécimale, séparées par le caractère ":". Les séquences de 0 peuvent être contractées ; notation partiellement pointée pour une adresse IPV4 incluse dans une adresse IPv6).
Une adresse IPv6 se distingue d'une adresse IPV4 car elle seule contient le caractère ":". - Cette fonction peut retourner un ensemble de résultats différents selon la plate-forme. En Java, la fonction retourne, pour une adresse IP donnée, deux résultats correspondant aux deux formes d'adresse possibles (IPv4 et IPv6). En génération C windows, une seule des deux représentations est retournée.
- La représentation textuelle d'une adresse IPv4 est de 15 caractères maximum.
La représentation textuelle d'une adresse IPv6 est de 45 caractères maximum.
- L'adresse IP retournée peut être une adresse IPv4 ou IPv6.
Par exemple
ALPHA(15) |
AdresseIp |
NUM_BIN_2 |
NumIP |
NUM_BIN_4 |
CodeRetour |
|
|
NumIP |
= 1 |
|
|
APPELER_DLL |
'VATOOLBX' 'VaToolBxGetLocalIP' AdresseIP 15 NumIP CodeRetour |
En sortie :
CodeRetour |
= 0 /* l'opération s'est déroulée correctement. |
NumIP |
= 0 /* pas d'autre adresse IP pour le poste. |
AdresseIP |
= '192.168.137.206' |
Liste des fonctions de la DLL VaToolBx par thème