WSAHtonl (Windows CE 5.0)

Windows CE 5.0
Send Feedback

This function converts a u_long from host byte order to network byte order.

int WSAHtonl(
  u_long hostlong,
  u_long FAR* lpnetlong


[in] Descriptor identifying a socket.
[in] 32-bit number in host byte order.
[out] Pointer to a 32-bit number in network byte order.

Return Values

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 WSAGetLastError function. The following table shows a list of possible error codes.

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


This function takes a 32-bit number in host byte order and returns a 32-bit number pointed to by the lpnetlong parameter in the network byte order associated with socket s.


OS Versions: Windows CE .NET 4.0 and later.
Header: Winsock2.h.
Link Library: Ws2.lib.

See Also

htonl | htons | ntohl | ntohs | WSANtohl | WSAHtons | WSANtohs | WSAGetLastError | WSAStartup

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.