htonll-Funktion (winsock2.h)

Artikel
03/04/2024

Die htonll-Inlinefunktion konvertiert einen nicht signierten __int64 vom Host in die TCP/IP-Netzwerkbytereihenfolge (big-endian).

Syntax

unsigned __int64 htonll(
  unsigned __int64 Value
);

Parameter

Value

Eine 64-Bit-Nummer ohne Vorzeichen in Hostbytereihenfolge.

Rückgabewert

Die htonll-Funktion gibt den Wert in der Tcp/IP-Netzwerkbytetereihenfolge zurück.

Hinweise

Die htonll-Inlinefunktion nimmt eine 64-Bit-Zahl in Hostbytereihenfolge an und gibt eine 64-Bit-Zahl in der Netzwerkbytereihenfolge zurück, die in TCP/IP-Netzwerken (der AF_INET- oder AF_INET6 Adressfamilie) verwendet wird.

Die htonll-Inlinefunktion kann verwendet werden, um eine IPv4-Adresse in Hostbytereihenfolge in die IPv4-Adresse in Netzwerkbytereihenfolge zu konvertieren. Diese Funktion überprüft nicht, ob der Wertparameter eine gültige IPv4-Adresse ist.

Die htonll-Inlinefunktion erfordert nicht, dass die Winsock-DLL zuvor mit einem erfolgreichen Aufruf der WSAStartup-Funktion geladen wurde.

Windows Phone 8: Diese Funktion wird für Windows Phone Store-Apps auf Windows Phone 8 und höher unterstützt.

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 8 [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	winsock2.h