9 out of 15 rated this helpful - Rate this topic

ntohs function

Applies to: desktop apps only

The ntohs function converts a u_short from TCP/IP network byte order to host byte order (which is little-endian on Intel processors).

Syntax

u_short WSAAPI ntohs(
  __in  u_short netshort
);

Parameters

netshort [in]

A 16-bit number in TCP/IP network byte order.

Return value

The ntohs function returns the value in host byte order. If the netshort parameter is already in host byte order, then this function will reverse it. It is up to the application to determine if the byte order must be reversed.

Remarks

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

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

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

Requirements

Minimum supported client

Windows 2000 Professional

Minimum supported server

Windows 2000 Server

Header

Winsock2.h

Library

Ws2_32.lib

DLL

Ws2_32.dll

See also

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

 

 

Send comments about this topic to Microsoft

Build date: 4/24/2012

Did you find this helpful?
(1500 characters remaining)
Community Content Add
Annotations FAQ