ntohl-Funktion (winsock.h)

Artikel
08/27/2023

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