WSANtohs

The Windows Sockets WSANtohs function converts a u_short from network byte order to host byte order.

int WSANtohs (
  SOCKET s,                  
  u_short netshort,          
  u_short FAR * lphostshort  
);
 

Parameters

s
[in] A descriptor identifying a socket.
netshort
[in] A 16-bit number in network byte order.
lphostshort
[out] A pointer to a 16-bit number in host byte order.

Remarks

The WSANtohs function takes a 16-bit number in the network byte order associated with socket s and returns a 16-bit number pointed to by the lphostshort parameter in host byte order.

Return Values

If no error occurs, WSANtohs returns zero. Otherwise, a value of SOCKET_ERROR is returned, and a specific error code can be retrieved by calling WSAGetLastError.

Error Codes

WSANOTINITIALISED A successful WSAStartup must occur before using this function.
WSAENETDOWN The network subsystem has failed.
WSAENOTSOCK The descriptor is not a socket.
WSAEFAULT The lphostshort parameter is not completely contained in a valid part of the user address space.

QuickInfo

  Windows NT: Yes
  Windows: Yes
  Windows CE: Unsupported.
  Header: Declared in winsock2.h.
  Import Library: Link with ws2_32.lib.

See Also

htonl, htons, ntohl, ntohs, WSAHtonl, WSANtohl, WSAHtons