Partager via


Fonction WSAHtons (winsock2.h)

La fonction WSAHtons convertit un u_short de l’ordre d’octet hôte en ordre d’octet réseau.

Syntaxe

int WSAAPI WSAHtons(
  [in]  SOCKET  s,
  [in]  u_short hostshort,
  [out] u_short *lpnetshort
);

Paramètres

[in] s

Descripteur identifiant un socket.

[in] hostshort

Nombre 16 bits dans l’ordre des octets de l’hôte.

[out] lpnetshort

Pointeur vers une mémoire tampon 16 bits pour recevoir le nombre dans l’ordre d’octet réseau.

Valeur retournée

Si aucune erreur ne se produit, WSAHtons 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
WSANOTINITIALISED
Un appel WSAStartup réussi doit se produire avant d’utiliser cette fonction.
WSAENETDOWN
Le sous-système réseau a échoué.
WSAENOTSOCK
Le descripteur n’est pas un socket.
WSAEFAULT
Le paramètre lpnetshort a la valeur NULL ou l’adresse pointée vers n’est pas entièrement contenue dans une partie valide de l’espace d’adressage utilisateur.

Remarques

La fonction WSAHtons prend un nombre de 16 bits dans l’ordre d’octets de l’hôte et retourne un nombre de 16 bits dans l’ordre d’octet réseau dans le nombre 16 bits pointé par le paramètre lpnetshort . Le socket transmis dans le paramètre s est utilisé pour déterminer l’ordre d’octet réseau requis en fonction de l’entrée de protocole du catalogue Winsock associée au socket. Cette fonctionnalité prend en charge les fournisseurs Winsock qui utilisent différentes commandes d’octets réseau.

Si le socket est destiné à la famille d’adresses AF_INET ou AF_INET6, la fonction WSAHtons peut être utilisée pour convertir un numéro de port IP dans l’ordre d’octet de l’hôte en numéro de port IP dans l’ordre d’octet réseau.

La fonction WSAHtons 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 d’adresses AF_INET OR AF_INET6, la fonction htons n’exige pas que la DLL Winsock soit chargée.

Windows Phone 8 : cette fonction est prise en charge pour les applications du Store Windows Phone 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

Condition requise Valeur
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

Voir aussi

InetNtop

WSAHtonl

WSANtohl

WSANtohs

Fonctions Winsock

Informations de référence sur Winsock

htonl

htons

inet_addr

inet_ntoa

ntohl

ntohs