Funzione WSAHtons (winsock2.h)

Articolo
08/27/2023

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

Sintassi

int WSAAPI WSAHtons(
  [in]  SOCKET  s,
  [in]  u_short hostshort,
  [out] u_short *lpnetshort
);

Parametri

[in] s

Descrittore che identifica un socket.

[in] hostshort

Numero a 16 bit nell'ordine di byte host.

[out] lpnetshort

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

Valore restituito

Se non si verifica alcun errore, WSAHtons restituisce zero. In caso contrario, viene restituito un valore di SOCKET_ERROR e un codice di errore specifico può essere recuperato chiamando WSAGetLastError.

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

Commenti

La funzione WSAHtons accetta un numero a 16 bit nell'ordine di byte host e restituisce un numero a 16 bit nell'ordine di byte di rete nel numero a 16 bit a cui punta il parametro lpnetshort . Il socket passato nel parametro s viene usato per determinare l'ordine di byte di rete richiesto in base alla voce del protocollo del catalogo Winsock associata al socket. Questa funzionalità supporta i 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 WSAHtons può essere usata per convertire un numero di porta IP in byte host per il numero di porta IP nell'ordine di byte di rete.

La funzione WSAHtons richiede che la DLL Winsock sia stata caricata in precedenza con una chiamata corretta alla funzione WSAStartup . Per l'uso con la famiglia di indirizzi OR AF_INET6 AF_INET, la funzione htons non richiede che venga caricata la DLL Winsock.

Windows Phone 8: questa funzione è supportata per le app Windows Phone Store 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