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