Función WSANtohs (winsock2.h)

Artículo
08/27/2023

La función WSANtohs convierte un u_short del orden de bytes de red para hospedar el orden de bytes.

Sintaxis

int WSAAPI WSANtohs(
  [in]  SOCKET  s,
  [in]  u_short netshort,
  [out] u_short *lphostshort
);

Parámetros

[in] s

Descriptor que identifica un socket.

[in] netshort

Número de 16 bits en orden de bytes de red.

[out] lphostshort

Puntero a un número de 16 bits para recibir el número en el orden de bytes del host.

Valor devuelto

Si no se produce ningún error, WSANtohs 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 lphostshort 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 WSANtohs toma un número de 16 bits en el orden de bytes de red y devuelve un número de 16 bits en el orden de bytes del host en el número de 16 bits al que apunta el parámetro lphostshort . 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 WSANtohs se puede usar para convertir un número de puerto IP en el orden de bytes de red al número de puerto IP en el orden de bytes del host.

La función WSANtohs requiere que el archivo DLL de Winsock se haya cargado previamente con una llamada correcta a la función WSAStartup . Para su uso con el AF_INET O AF_INET6 familia de direcciones, la función ntohs 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

Requisito	Value
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