Share via


Função WSANtohs (winsock2.h)

A função WSANtohs converte um u_short da ordem de byte de rede para a ordem de bytes de host.

Sintaxe

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

Parâmetros

[in] s

Um descritor que identifica um soquete.

[in] netshort

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

[out] lphostshort

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

Retornar valor

Se nenhum erro ocorrer, WSANtohs retornará zero. Caso contrário, um valor de SOCKET_ERROR será retornado e um código de erro específico poderá 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 lphostshort é 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 WSANtohs usa um número de 16 bits na ordem de bytes de rede e retorna um número de 16 bits na ordem de bytes do host no número de 16 bits apontado pelo parâmetro lphostshort . O soquete passado no parâmetro s é usado para determinar a ordem de bytes de rede necessária com base na entrada do protocolo de catálogo winsock associada ao soquete. Esse recurso dá suporte a provedores Winsock que usam pedidos de bytes de rede diferentes.

Se o soquete for para a família de endereços AF_INET ou AF_INET6, a função WSANtohs poderá ser usada para converter um número de porta IP na ordem de byte de rede para o número da porta IP na ordem de bytes do host.

A função WSANtohs requer que a DLL do Winsock tenha sido carregada anteriormente com uma chamada bem-sucedida para a função WSAStartup . Para uso com a família de endereços AF_INET OR AF_INET6, a função ntohs não exige que a DLL do 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 posteriores.

Requisitos

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

Confira também

InetNtop

WSAHtonl

WSAHtons

WSANtohl

Funções Winsock

Referência de Winsock

Htonl

Htons

Inet_addr

inet_ntoa

ntohl

ntohs