Click to Rate and Give Feedback
MSDN
MSDN Library
Networking
Network Protocols
Windows Sockets 2
Winsock Reference
Winsock Functions
 htons Function
htons Function

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

Syntax

C++
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.

Requirements

Minimum supported clientWindows 2000 Professional
Minimum supported serverWindows 2000 Server
HeaderWinsock2.h
LibraryWs2_32.lib
DLLWs2_32.dll

See Also

Winsock Reference
Winsock Functions
htonl
inet_addr
inet_ntoa
InetNtop
ntohl
ntohs
WSAHtonl
WSAHtons
WSANtohl
WSANtohs

Send comments about this topic to Microsoft

Build date: 11/12/2009

Community Content   What is Community Content?
Add new content RSS  Annotations
Processing
© 2009 Microsoft Corporation. All rights reserved. Terms of Use | Trademarks | Privacy Statement | Site Feedback
Page view tracker