ntohll-Funktion (winsock2.h)

Artikel
03/06/2024

Die Ntohll-Inlinefunktion konvertiert einen nicht signierten __int64 aus tcp/IP-Netzwerkreihenfolge in host byte order (little-endian auf Intel-Prozessoren).

Syntax

unsigned __int64 ntohll(
  unsigned __int64 Value
);

Parameter

Value

Eine nicht signierte __int64 Zahl in TCP/IP-Netzwerkbytereihenfolge.

Rückgabewert

Die ntohll-Funktion gibt den im Wertparameter angegebenen Wert mit umgekehrter Bytereihenfolge zurück. Wenn sich der Wert bereits in der Hostbytereihenfolge befindet, wird er von dieser Funktion umgekehrt. Es liegt an der Anwendung, zu bestimmen, ob die Bytereihenfolge umgekehrt werden muss.

Hinweise

Die ntohll-Inlinefunktion nimmt eine nicht signierte __int64 Zahl in TCP/IP-Netzwerkbytereihenfolge (die AF_INET- oder AF_INET6-Adressfamilie) an und gibt eine 32-Bit-Zahl in Hostbytereihenfolge zurück.

Die ntohll-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 Wertparameter eine gültige IPv4-Adresse ist.

Die ntohll-Funktion 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