Compartir a través de


Función WSAHtonl (winsock2.h)

La función WSAHtonl convierte un u_long del orden de bytes del host al orden de bytes de red.

Sintaxis

int WSAAPI WSAHtonl(
  [in]  SOCKET s,
  [in]  u_long hostlong,
  [out] u_long *lpnetlong
);

Parámetros

[in] s

Descriptor que identifica un socket.

[in] hostlong

Número de 32 bits en el orden de bytes del host.

[out] lpnetlong

Puntero a un número de 32 bits para recibir el número en orden de bytes de red.

Valor devuelto

Si no se produce ningún error, WSAHtonl devuelve cero. De lo contrario, se devuelve un valor de SOCKET_ERROR y se puede recuperar un código de error específico llamando a WSAGetLastError.

Código de error Significado
WSANOTINITIALISED
Debe producirse una llamada de WSAStartup correcta antes de usar esta función.
WSAENETDOWN
Error en el subsistema de red.
WSAENOTSOCK
El descriptor no es un socket.
WSAEFAULT
El parámetro lpnetlong es NULL o la dirección a la que apunta no se incluye completamente en una parte válida del espacio de direcciones del usuario.

Comentarios

La función WSAHtonl toma un número de 32 bits en el orden de bytes del host y devuelve un número de 32 bits en el orden de bytes de red en el número de 32 bits al que apunta el parámetro lpnetlong . El socket pasado en el parámetro s se usa para determinar el orden de bytes de red necesario en función de la entrada del protocolo de catálogo winsock asociada al socket. Esta característica admite proveedores de Winsock que usan diferentes pedidos de bytes de red.

Si el socket es para la familia de direcciones AF_INET o AF_INET6, la función WSAHtonl se puede usar para convertir una dirección IPv4 en el orden de bytes del host a la dirección IPv4 en el orden de bytes de red. Esta función no realiza ninguna comprobación para determinar si el parámetro hostlong es una dirección IPv4 válida.

La función WSAHtonl requiere que el archivo DLL de Winsock se haya cargado previamente con una llamada correcta a la función WSAStartup . Para su uso con la familia AF_INET o AF_INET6, la función htonl no requiere que se cargue el archivo DLL de Winsock.

Windows Phone 8: esta función es compatible con las aplicaciones de Windows Phone Store en Windows Phone 8 y versiones posteriores.

Windows 8.1 y Windows Server 2012 R2: esta función es compatible con las aplicaciones de la Tienda Windows en Windows 8.1, Windows Server 2012 R2 y versiones posteriores.

Requisitos

   
Cliente mínimo compatible Windows 8.1, Windows Vista [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2003 [aplicaciones de escritorio | aplicaciones para UWP]
Plataforma de destino Windows
Encabezado winsock2.h
Library Ws2_32.lib
Archivo DLL Ws2_32.dll

Consulte también

InetNtop

WSAHtons

WSANtohl

WSANtohs

Funciones winsock

Referencia de Winsock

htonl

htons

inet_addr

inet_ntoa

ntohl

ntohs