Funzione WSANtohl (winsock2.h)

Articolo
08/27/2023

La funzione WSANtohl converte un u_long dall'ordine di byte di rete per ospitare l'ordine di byte.

Sintassi

int WSAAPI WSANtohl(
  [in]  SOCKET s,
  [in]  u_long netlong,
  [out] u_long *lphostlong
);

Parametri

[in] s

Descrittore che identifica un socket.

[in] netlong

Numero a 32 bit nell'ordine di byte di rete.

[out] lphostlong

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

Valore restituito

Se non si verifica alcun errore, WSANtohl 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 lphostlong è NULL o l'indirizzo a cui punta non è completamente contenuto in una parte valida dello spazio degli indirizzi utente.

Commenti

La funzione WSANtohl accetta un numero a 32 bit nell'ordine di byte di rete e restituisce un numero a 32 bit nell'ordine di byte host nel numero a 32 bit a cui punta il parametro lphostlong . 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 WSANtohl può essere usata per convertire un indirizzo IPv4 in un byte di rete per l'indirizzo IPv4 nell'ordine di byte host. Questa funzione non esegue alcun controllo per determinare se il parametro netlong è un indirizzo IPv4 valido.

La funzione WSANtohl richiede che la DLL Winsock sia stata caricata in precedenza con una chiamata corretta alla funzione WSAStartup . Per l'uso con la famiglia AF_INET o AF_INET6, la funzione ntohl 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


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