htonl-Funktion (winsock2.h)
Die htonl-Funktion konvertiert eine u_long vom Host in tcp/IP-Netzwerk-Bytereihenfolge (was big-endian ist).
Syntax
u_long WSAAPI htonl(
[in] u_long hostlong
);
Parameter
[in] hostlong
Eine 32-Bit-Nummer in Der Host byte-Reihenfolge.
Rückgabewert
Die htonl-Funktion gibt den Wert in der Netzwerk-Bytereihenfolge von TCP/IP zurück.
Bemerkungen
Die htonl-Funktion übernimmt eine 32-Bit-Zahl in Host-Bytereihenfolge und gibt eine 32-Bit-Zahl in der Netzwerk-Bytereihenfolge zurück, die in TCP/IP-Netzwerken verwendet wird (die AF_INET- oder AF_INET6 Adressfamilie).
Die htonl-Funktion kann verwendet werden, um eine IPv4-Adresse in Host-Byte-Reihenfolge in die IPv4-Adresse in Netzwerk-Bytereihenfolge zu konvertieren. Diese Funktion überprüft nicht, ob der Hostlong-Parameter eine gültige IPv4-Adresse ist.
Die htonl-Funktion erfordert nicht, dass die Winsock-DLL zuvor mit einem erfolgreichen Aufruf der WSAStartup-Funktion geladen wurde.
Windows 8.1 und Windows Server 2012 R2: Diese Funktion wird für Windows Store-Apps auf Windows 8.1, Windows Server 2012 R2 und höher unterstützt.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 8.1, Windows Vista [Desktop-Apps | UWP-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [Desktop-Apps | UWP-Apps] |
| Zielplattform | Windows |
| Kopfzeile | winsock2.h (enthalten Winsock2.h) |
| Bibliothek | Ws2_32.lib |
| DLL | Ws2_32.dll |