Función WSANtohl (winsock2.h)
La función WSANtohl convierte un u_long del orden de bytes de red para hospedar el orden de bytes.
Sintaxis
int WSAAPI WSANtohl(
[in] SOCKET s,
[in] u_long netlong,
[out] u_long *lphostlong
);
Parámetros
[in] s
Descriptor que identifica un socket.
[in] netlong
Número de 32 bits en orden de bytes de red.
[out] lphostlong
Puntero a un número de 32 bits para recibir el número en el orden de bytes del host.
Valor devuelto
Si no se produce ningún error, WSANtohl 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 |
|---|---|
| Debe producirse una llamada de WSAStartup correcta antes de usar esta función. | |
| Error en el subsistema de red. | |
| El descriptor no es un socket. | |
| El parámetro lphostlong es NULL o la dirección a la que apunta no está completamente contenida en una parte válida del espacio de direcciones del usuario. |
Comentarios
La función WSANtohl toma un número de 32 bits en el orden de bytes de red y devuelve un número de 32 bits en el orden de bytes del host en el número de 32 bits al que apunta el parámetro lphostlong . 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 WSANtohl se puede usar para convertir una dirección IPv4 en el orden de bytes de red a la dirección IPv4 en el orden de bytes del host. Esta función no realiza ninguna comprobación para determinar si el parámetro netlong es una dirección IPv4 válida.
La función WSANtohl 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 ntohl 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 |