Funzione WSAHtonl (winsock2.h)
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 |
|---|---|
| Prima di usare questa funzione, è necessario eseguire una chiamata WSAStartup riuscita. | |
| Il sottosistema di rete non è riuscito. | |
| Il descrittore non è un socket. | |
| 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 |