WSAHtonl, fonction (winsock2.h)
La fonction WSAHtonl convertit un u_long de l’ordre d’octet de l’hôte en ordre d’octets réseau.
Syntaxe
int WSAAPI WSAHtonl(
[in] SOCKET s,
[in] u_long hostlong,
[out] u_long *lpnetlong
);
Paramètres
[in] s
Descripteur identifiant un socket.
[in] hostlong
Nombre 32 bits dans l’ordre d’octet de l’hôte.
[out] lpnetlong
Pointeur vers un nombre 32 bits pour recevoir le nombre dans l’ordre d’octets réseau.
Valeur retournée
Si aucune erreur ne se produit, WSAHtonl retourne zéro. Sinon, une valeur de SOCKET_ERROR est retournée et un code d’erreur spécifique peut être récupéré en appelant WSAGetLastError.
| Code d'erreur | Signification |
|---|---|
| Un appel WSAStartup réussi doit se produire avant d’utiliser cette fonction. | |
| Le sous-système réseau a échoué. | |
| Le descripteur n’est pas un socket. | |
| Le paramètre lpnetlong est NULL ou l’adresse pointée n’est pas entièrement contenue dans une partie valide de l’espace d’adressage utilisateur. |
Remarques
La fonction WSAHtonl prend un nombre de 32 bits dans l’ordre d’octets de l’hôte et retourne un nombre de 32 bits dans l’ordre d’octet du réseau dans le nombre 32 bits vers lequel pointe le paramètre lpnetlong . Le socket passé dans le paramètre s est utilisé pour déterminer l’ordre d’octets réseau requis en fonction de l’entrée de protocole de catalogue Winsock associée au socket. Cette fonctionnalité prend en charge les fournisseurs Winsock qui utilisent des commandes d’octets réseau différentes.
Si le socket est destiné à la famille d’adresses AF_INET ou AF_INET6, la fonction WSAHtonl peut être utilisée pour convertir une adresse IPv4 dans l’ordre d’octet de l’hôte en adresse IPv4 dans l’ordre d’octets réseau. Cette fonction n’effectue aucune vérification pour déterminer si le paramètre hostlong est une adresse IPv4 valide.
La fonction WSAHtonl nécessite que la DLL Winsock ait déjà été chargée avec un appel réussi à la fonction WSAStartup . Pour une utilisation avec la famille AF_INET ou AF_INET6, la fonction htonl ne nécessite pas que la DLL Winsock soit chargée.
Windows Phone 8 : cette fonction est prise en charge pour les applications Windows Phone Store sur Windows Phone 8 et versions ultérieures.
Windows 8.1 et Windows Server 2012 R2 : cette fonction est prise en charge pour les applications du Windows Store sur Windows 8.1, Windows Server 2012 R2 et versions ultérieures.
Configuration requise
| Client minimal pris en charge | Windows 8.1, Windows Vista [applications de bureau | Applications UWP] |
| Serveur minimal pris en charge | Windows Server 2003 [applications de bureau | applications UWP] |
| Plateforme cible | Windows |
| En-tête | winsock2.h |
| Bibliothèque | Ws2_32.lib |
| DLL | Ws2_32.dll |