Funzione WSAHtonl (winsock2.h)

Articolo
08/27/2023

La funzione WSAHtonl converte un u_long da un ordine di byte host all'ordine di byte di rete.

Sintassi

int WSAAPI WSAHtonl(
  [in]  SOCKET s,
  [in]  u_long hostlong,
  [out] u_long *lpnetlong
);

Parametri

[in] s

Descrittore che identifica un socket.

[in] hostlong

Numero a 32 bit nell'ordine di byte host.

[out] lpnetlong

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

Valore restituito

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

Commenti

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

La funzione WSAHtonl 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 htonl 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