Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

htons function

The htons function converts a u_short from host to TCP/IP network byte order (which is big-endian).

Syntax


u_short WSAAPI htons(
  _In_  u_short hostshort
);

Parameters

hostshort [in]

A 16-bit number in host byte order.

Return value

The htons function returns the value in TCP/IP network byte order.

Remarks

The htons function takes a 16-bit number in host byte order and returns a 16-bit number in network byte order used in TCP/IP networks (the AF_INET or AF_INET6 address family).

The htons function can be used to convert an IP port number in host byte order to the IP port number in network byte order.

The htons function does not require that the Winsock DLL has previously been loaded with a successful call to the WSAStartup function.

Windows 8.1 and Windows Server 2012 R2: This function is supported for Windows Store apps on Windows 8.1, Windows Server 2012 R2, and later.

Requirements

Minimum supported client

Windows 8.1, Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Winsock2.h

Library

Ws2_32.lib

DLL

Ws2_32.dll

See also

htond
htonf
htonl
htonll
inet_addr
inet_ntoa
InetNtop
InetPton
ntohd
ntohf
ntohl
ntohll
ntohs
WSAHtonl
WSAHtons
WSANtohl
WSANtohs

 

 

Community Additions

Show:
© 2014 Microsoft