Condividi tramite


Funzione WSANtohs (winsock2.h)

La funzione WSANtohs converte un u_short dall'ordine dei byte di rete all'ordine dei byte host.

Sintassi

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

Parametri

[in] s

Descrittore che identifica un socket.

[in] netshort

Numero a 16 bit nell'ordine dei byte di rete.

[out] lphostshort

Puntatore a un numero a 16 bit per ricevere il numero in ordine di byte host.

Valore restituito

Se non si verifica alcun errore, WSANtohs restituisce zero. In caso contrario, viene restituito un valore di SOCKET_ERROR e è possibile recuperare un codice di errore specifico chiamando WSAGetLastError.

Codice di errore Significato
WSANOTINITIALISED
Prima di usare questa funzione, è necessario che venga eseguita una chiamata WSAStartup riuscita.
WSAENETDOWN
Il sottosistema di rete non è riuscito.
WSAENOTSOCK
Il descrittore non è un socket.
WSAEFAULT
Il parametro lphostshort è NULL o l'indirizzo a cui punta non è completamente contenuto in una parte valida dello spazio indirizzi utente.

Commenti

La funzione WSANtohs accetta un numero a 16 bit in ordine di byte di rete e restituisce un numero a 16 bit in ordine di byte host nel numero a 16 bit a cui punta il parametro lphostshort . Il socket passato nel parametro s viene usato per determinare l'ordine dei byte di rete richiesto in base alla voce del protocollo del catalogo Winsock associata al socket. Questa funzionalità supporta provider Winsock che usano ordini di byte di rete diversi.

Se il socket è per la famiglia di indirizzi AF_INET o AF_INET6, la funzione WSANtohs può essere usata per convertire un numero di porta IP in byte di rete nell'ordine di byte host.

La funzione WSANtohs richiede che la DLL Winsock sia stata precedentemente caricata con una chiamata corretta alla funzione WSAStartup . Per l'uso con la famiglia di indirizzi AF_INET OR AF_INET6, la funzione ntohs non richiede il caricamento della DLL Winsock.

Windows Phone 8: questa funzione è supportata per le app dello Store di Windows Phone in Windows Phone 8 e versioni successive.

Windows 8.1 e Windows Server 2012 R2: questa funzione è supportata per le app di Windows Store in Windows 8.1, Windows Server 2012 R2 e versioni successive.

Requisiti

Requisito Valore
Client minimo supportato Windows 8.1, Windows Vista [app desktop | App UWP]
Server minimo supportato Windows Server 2003 [app desktop | App UWP]
Piattaforma di destinazione Windows
Intestazione winsock2.h
Libreria Ws2_32.lib
DLL Ws2_32.dll

Vedi anche

InetNtop

WSAHtonl

WSAHtons

WSANtohl

Funzioni Winsock

Informazioni di riferimento su Winsock

htonl

htons

inet_addr

inet_ntoa

ntohl

ntohs