ntohl-Funktion (winsock.h)
Die ntohl-Funktion konvertiert einen u_long von der TCP/IP-Netzwerkreihenfolge in die Hostbytereihenfolge (die auf Intel-Prozessoren Little-Endian ist).
Syntax
u_long ntohl(
[in] u_long netlong
);
Parameter
[in] netlong
Eine 32-Bit-Zahl in TCP/IP-Netzwerkbytereihenfolge.
Rückgabewert
Die ntohl-Funktion gibt den im netlong-Parameter angegebenen Wert mit umgekehrter Bytereihenfolge zurück. Wenn sich netlong bereits in der Hostbytereihenfolge befindet, kehrt diese Funktion dies um. Es liegt an der Anwendung, zu bestimmen, ob die Bytereihenfolge umgekehrt werden muss.
Hinweise
Die ntohl-Funktion akzeptiert eine 32-Bit-Zahl in TCP/IP-Netzwerkbytereihenfolge (die AF_INET oder AF_INET6 Adressfamilie) und gibt eine 32-Bit-Zahl in Hostbytereihenfolge zurück.
Die ntohl-Funktion kann verwendet werden, um eine IPv4-Adresse in Netzwerkbytereihenfolge in die IPv4-Adresse in Hostbytereihenfolge zu konvertieren. Diese Funktion führt keine Überprüfung durch, um festzustellen, ob der netlong-Parameter eine gültige IPv4-Adresse ist.
Die ntohl-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 unter 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 | winsock.h (Winsock2.h einschließen) |
| Bibliothek | Ws2_32.lib |
| DLL | Ws2_32.dll |