fonction ntohl (winsock.h)

Article
08/27/2023

La fonction ntohl convertit un u_long de l’ordre réseau TCP/IP en ordre d’octet hôte (qui est peu endian sur les processeurs Intel).

Syntaxe

u_long ntohl(
  [in] u_long netlong
);

Paramètres

[in] netlong

Nombre 32 bits dans l’ordre d’octet du réseau TCP/IP.

Valeur retournée

La fonction ntohl retourne la valeur fournie dans le paramètre netlong avec l’ordre d’octet inversé. Si netlong est déjà dans l’ordre d’octet de l’hôte, cette fonction l’inverse. Il appartient à l’application de déterminer si l’ordre des octets doit être inversé.

Remarques

La fonction ntohl prend un nombre 32 bits dans l’ordre d’octet du réseau TCP/IP (famille d’adresses AF_INET ou AF_INET6) et retourne un nombre 32 bits dans l’ordre d’octet de l’hôte.

La fonction ntohl peut être utilisée pour convertir une adresse IPv4 dans l’ordre d’octet réseau en adresse IPv4 dans l’ordre d’octet de l’hôte. Cette fonction n’effectue aucune vérification pour déterminer si le paramètre netlong est une adresse IPv4 valide.

La fonction ntohl n’exige pas que la DLL Winsock ait déjà été chargée avec un appel réussi à la fonction WSAStartup .

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	winsock.h (inclure Winsock2.h)
Bibliothèque	Ws2_32.lib
DLL	Ws2_32.dll