WSANtohs, fonction (winsock2.h)

Article
08/27/2023

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

Syntaxe

int WSAAPI WSANtohs(
  [in]  SOCKET  s,
  [in]  u_short netshort,
  [out] u_short *lphostshort
);

Paramètres

[in] s

Descripteur identifiant un socket.

[in] netshort

Nombre 16 bits dans l’ordre d’octets réseau.

[out] lphostshort

Pointeur vers un nombre 16 bits pour recevoir le nombre dans l’ordre d’octet de l’hôte.

Valeur retournée

Si aucune erreur ne se produit, WSANtohs 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 lphostshort a la valeur 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 WSANtohs prend un nombre de 16 bits dans l’ordre d’octets réseau et retourne un nombre de 16 bits dans l’ordre d’octet de l’hôte dans le nombre 16 bits vers lequel pointe le paramètre lphostshort . 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 WSANtohs 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 WSANtohs 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 ntohs 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

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