WSAHtonl  KKC8K_ 

The Windows Sockets WSAHtonl function converts a u_long from host byte order to network byte order.

int WSAHtonl (

    SOCKET s,

 

    u_long hostlong,

 

    u_long FAR * lpnetlong

 

   );

 

 

Parameters

s

[in] A descriptor identifying a socket.

hostlong

[in] A 32-bit number in host byte order.

lpnetlong

[out] A pointer to a 32-bit number in network byte order.

 

Remarks

This routine 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.

Return Values

If no error occurs, WSAHtonl returns zero. Otherwise, a value of SOCKET_ERROR is returned, and a specific error code may be retrieved by calling WSAGetLastError.

Error Codes

WSANOTINITIALISED

A successful WSAStartup must occur before using this function.

WSAENETDOWN

The network subsystem has failed.

WSAENOTSOCK

The descriptor is not a socket.

WSAEFAULT

The lpnetlong argument is not totally contained in a valid part of the user address space.

 

See Also

htonl, htons, ntohl, ntohs, WSANtohl, WSAHtons, WSANtohs