ntohl-Funktion (winsock2.h)
Die ntohl-Funktion konvertiert eine u_long von TCP/IP-Netzwerkreihenfolge in Hostbytereihenfolge (little-endian auf Intel-Prozessoren).
Syntax
u_long WSAAPI 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, wird es von dieser Funktion umgekehrt. Es liegt an der Anwendung, zu bestimmen, ob die Bytereihenfolge umgekehrt werden muss.
Hinweise
Die ntohl-Funktion nimmt eine 32-Bit-Zahl in TCP/IP-Netzwerkbytereihenfolge (die AF_INET oder AF_INET6 Adressfamilie) an 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 überprüft nicht, 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 | winsock2.h (einschließlich Winsock2.h) |
| Bibliothek | Ws2_32.lib |
| DLL | Ws2_32.dll |