Função WSAHtonl (winsock2.h)
A função WSAHtonl converte um u_long de ordem de byte de host em ordem de byte de rede.
Sintaxe
int WSAAPI WSAHtonl(
[in] SOCKET s,
[in] u_long hostlong,
[out] u_long *lpnetlong
);
Parâmetros
[in] s
Um descritor que identifica um soquete.
[in] hostlong
Um número de 32 bits na ordem de bytes do host.
[out] lpnetlong
Um ponteiro para um número de 32 bits para receber o número na ordem de bytes de rede.
Valor retornado
Se nenhum erro ocorrer, WSAHtonl 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 |
|---|---|
| Uma chamada WSAStartup bem-sucedida deve ocorrer antes de usar essa função. | |
| O subsistema de rede falhou. | |
| O descritor não é um soquete. | |
| O parâmetro lpnetlong é 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 WSAHtonl usa um número de 32 bits na ordem de byte do host e retorna um número de 32 bits na ordem de bytes de rede no número de 32 bits apontado pelo parâmetro lpnetlong . 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 WSAHtonl poderá ser usada para converter um endereço IPv4 na ordem de byte do host para o endereço IPv4 na ordem de byte de rede. Essa função não faz nenhuma verificação para determinar se o parâmetro hostlong é um endereço IPv4 válido.
A função WSAHtonl requer 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 htonl 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 |