htonl-Funktion (winsock2.h)
Die htonl-Funktion konvertiert einen u_long vom Host in die TCP/IP-Netzwerkbytereihenfolge (big-endian).
Syntax
u_long WSAAPI htonl(
[in] u_long hostlong
);
Parameter
[in] hostlong
Eine 32-Bit-Zahl in Hostbytereihenfolge.
Rückgabewert
Die htonl-Funktion gibt den Wert in der Netzwerkbytereihenfolge von TCP/IP zurück.
Hinweise
Die htonl-Funktion akzeptiert eine 32-Bit-Zahl in Hostbytereihenfolge und gibt eine 32-Bit-Zahl in der Netzwerkbytereihenfolge zurück, die in TCP/IP-Netzwerken (der AF_INET- oder AF_INET6-Adressfamilie) verwendet wird.
Die htonl-Funktion kann verwendet werden, um eine IPv4-Adresse in Hostbytereihenfolge in die IPv4-Adresse in Netzwerkbytereihenfolge zu konvertieren. Diese Funktion führt keine Überprüfung durch, um festzustellen, 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
| Anforderung | Wert |
|---|---|
| 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 (Winsock2.h einschließen) |
| Bibliothek | Ws2_32.lib |
| DLL | Ws2_32.dll |