htonl-Funktion (winsock.h)

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

Weitere Informationen

InetNtop

InetPton

WSAHtonl

WSAHtons

WSANtohl

WSANtohs

htond

htonf

htonll

htons

inet_addr

inet_ntoa

ntohd

ntohf

ntohll

ntohs