htonl-Funktion (winsock.h)

Artikel
03/04/2024

Die htonl-Funktion konvertiert einen u_long vom Host in die TCP/IP-Netzwerkbytereihenfolge (big-endian).

Syntax

u_long 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	winsock.h (Winsock2.h einschließen)
Bibliothek	Ws2_32.lib
DLL	Ws2_32.dll