Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This function converts a u_shortfrom network byte order to host byte order.

Syntax 

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

Parameters

s

[in] Descriptor identifying a socket.

netshort

[in] 16-bit number in network byte order.

lphostshort

[out] Pointer to a 16-bit number in host byte order.

Return Value

If no error occurs, this function returns zero. If an error occurs, a value of SOCKET_ERROR is returned, and a specific error code can be retrieved by calling the WSAGetLastErrorfunction. The following table shows a list of possible error codes.

Error code Description

WSANOTINITIALISED

A successful WSAStartupcall must occur before using this function.

WSAENETDOWN

The network subsystem has failed.

WSAENOTSOCK

The descriptor is not a socket.

WSAEFAULT

The lphostshortparameter is not completely contained in a valid part of the user address space.

Remarks

This function takes a 16-bit number in the network byte order associated with socket sand returns a 16-bit number pointed to by the lphostshortparameter in host byte order.

Requirements

Header winsock2.h
Library Ws2.lib
Windows Embedded CE Windows CE .NET 4.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also