Função WSANtohl (winsock2.h)

Artigo
03/08/2023

A função WSANtohl converte um u_long da ordem de byte de rede para a ordem de byte do host.

Sintaxe

int WSAAPI WSANtohl(
  [in]  SOCKET s,
  [in]  u_long netlong,
  [out] u_long *lphostlong
);

Parâmetros

[in] s

Um descritor que identifica um soquete.

[in] netlong

Um número de 32 bits na ordem de bytes de rede.

[out] lphostlong

Um ponteiro para um número de 32 bits para receber o número na ordem de byte do host.

Valor retornado

Se nenhum erro ocorrer, WSANtohl retornará zero. Caso contrário, um valor de SOCKET_ERROR é retornado e um código de erro específico pode ser recuperado chamando WSAGetLastError.

Código do erro	Significado
WSANOTINITIALISED	Uma chamada WSAStartup bem-sucedida deve ocorrer antes de usar essa função.
WSAENETDOWN	O subsistema de rede falhou.
WSAENOTSOCK	O descritor não é um soquete.
WSAEFAULT	O parâmetro lphostlong é NULL ou o endereço apontado não está completamente contido em uma parte válida do espaço de endereço do usuário.

Comentários

A função WSANtohl usa um número de 32 bits na ordem de byte de rede e retorna um número de 32 bits na ordem de bytes do host no número de 32 bits apontado pelo parâmetro lphostlong . O soquete passado no parâmetro s é usado para determinar a ordem de byte de rede necessária com base na entrada de protocolo do catálogo winsock associada ao soquete. Esse recurso dá suporte a provedores Winsock que usam diferentes pedidos de bytes de rede.

Se o soquete for para a família de endereços AF_INET ou AF_INET6, a função WSANtohl poderá ser usada para converter um endereço IPv4 na ordem de byte de rede para o endereço IPv4 na ordem de byte do host. Essa função não faz nenhuma verificação para determinar se o parâmetro netlong é um endereço IPv4 válido.

A função WSANtohl exige que a DLL winsock tenha sido carregada anteriormente com uma chamada bem-sucedida para a função WSAStartup . Para uso com a família AF_INET ou AF_INET6, a função ntohl não exige que a DLL winsock seja carregada.

Windows Phone 8: essa função tem suporte para aplicativos da Windows Phone Store no Windows Phone 8 e posterior.

Windows 8.1 e Windows Server 2012 R2: essa função tem suporte para aplicativos da Windows Store em Windows 8.1, Windows Server 2012 R2 e posterior.

Requisitos


Cliente mínimo com suporte	Windows 8.1, Windows Vista [aplicativos da área de trabalho \| Aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2003 [aplicativos da área de trabalho \| Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	winsock2.h
Biblioteca	Ws2_32.lib
DLL	Ws2_32.dll