WSAHtons
This function converts a u_short from host byte order to network byte order.
int WSAHtons(
SOCKET s,
u_short hostshort,
u_short FAR* lpnetshort
);
Parameters
- s
[in] Descriptor identifying a socket. - hostshort
[in] 16-bit number in host byte order. - lpnetshort
[out] Pointer to a 16-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 the 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 lpnetshort parameter is not completely contained in a valid part of the user address space. |
Remarks
This function takes a 16-bit number in host byte order and returns a 16-bit number pointed to by the lpnetshort parameter in the network byte order associated with socket s.
Requirements
OS Versions: Windows CE .NET 4.0 and later.
Header: Winsock2.h.
Link Library: Ws2.lib.
See Also
htonl | htons | ntohl | ntohs | WSAHtonl | WSANtohl | WSANtohs | WSAGetLastError | WSAStartup
Last updated on Saturday, April 10, 2004
© 1992-2003 Microsoft Corporation. All rights reserved.