Funzione WSANtohs (winsock2.h)

Articolo
08/27/2023

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