fonction ntohs (winsock.h)

Article
08/27/2023

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

Syntaxe

u_short ntohs(
  [in] u_short netshort
);

Paramètres

[in] netshort

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

Valeur retournée

La fonction ntohs retourne la valeur dans l’ordre d’octet de l’hôte. Si le paramètre netshort 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 ntohs prend un nombre de 16 bits dans l’ordre d’octet du réseau TCP/IP (la famille d’adresses AF_INET ou AF_INET6) et retourne un nombre de 16 bits dans l’ordre d’octet de l’hôte.

La fonction ntohs peut être utilisée pour convertir un numéro de port IP dans l’ordre d’octet réseau en numéro de port IP dans l’ordre d’octet de l’hôte.

La fonction ntohs 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