Função ntohl (winsock.h)

Artigo
08/27/2023

A função ntohl converte um u_long da ordem de rede TCP/IP para a ordem de byte de host (que é little-endian em processadores Intel).

Sintaxe

u_long ntohl(
  [in] u_long netlong
);

Parâmetros

[in] netlong

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

Valor retornado

A função ntohl retorna o valor fornecido no parâmetro netlong com a ordem de byte invertida. Se netlong já estiver em ordem de byte de host, essa função a reverterá. Cabe ao aplicativo determinar se a ordem de byte deve ser revertida.

Comentários

A função ntohl usa um número de 32 bits na ordem de byte de rede TCP/IP (a família de endereços AF_INET ou AF_INET6) e retorna um número de 32 bits na ordem de byte do host.

A função ntohl pode 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 ntohl não exige que a DLL winsock tenha sido carregada anteriormente com uma chamada bem-sucedida para a função WSAStartup .

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	winsock.h (inclua Winsock2.h)
Biblioteca	Ws2_32.lib
DLL	Ws2_32.dll