WSAHtonl-Funktion (winsock2.h)

Die WSAHtonl-Funktion konvertiert einen u_long von der Hostbytereihenfolge in die Netzwerkbytereihenfolge.

Syntax

int WSAAPI WSAHtonl(
  [in]  SOCKET s,
  [in]  u_long hostlong,
  [out] u_long *lpnetlong
);

Parameter

[in] s

Ein Deskriptor, der einen Socket identifiziert.

[in] hostlong

Eine 32-Bit-Zahl in Hostbytereihenfolge.

[out] lpnetlong

Ein Zeiger auf eine 32-Bit-Zahl, um die Zahl in der Netzwerkbytereihenfolge zu empfangen.

Rückgabewert

Wenn kein Fehler auftritt, gibt WSAHtonl null zurück. Andernfalls wird der Wert SOCKET_ERROR zurückgegeben, und ein bestimmter Fehlercode kann durch Aufrufen von WSAGetLastError abgerufen werden.

Fehlercode Bedeutung
WSANOTINITIALISIERT
Vor der Verwendung dieser Funktion muss ein erfolgreicher WSAStartup-Aufruf erfolgen.
WSAENETDOWN
Fehler beim Netzwerksubsystem.
WSAENOTSOCK
Der Deskriptor ist kein Socket.
WSAEFAULT
Der lpnetlong-Parameter ist NULL , oder die Adresse, auf die verwiesen wird, ist nicht vollständig in einem gültigen Teil des Benutzeradressraums enthalten.

Hinweise

Die WSAHtonl-Funktion akzeptiert eine 32-Bit-Zahl in Hostbytereihenfolge und gibt eine 32-Bit-Zahl in Netzwerkbytereihenfolge in der 32-Bit-Zahl zurück, auf die der lpnetlong-Parameter verweist. Der socket, der im s-Parameter übergeben wird, wird verwendet, um die erforderliche Netzwerkbytereihenfolge basierend auf dem Winsock-Katalogprotokolleintrag zu bestimmen, der dem Socket zugeordnet ist. Dieses Feature unterstützt Winsock-Anbieter, die verschiedene Netzwerkbyteaufträge verwenden.

Wenn der Socket für die AF_INET- oder AF_INET6-Adressfamilie bestimmt ist, kann die WSAHtonl-Funktion 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 WSAHtonl-Funktion erfordert, dass die Winsock-DLL zuvor mit einem erfolgreichen Aufruf der WSAStartup-Funktion geladen wurde. Für die Verwendung mit der AF_INET- oder AF_INET6-Familie erfordert die htonl-Funktion nicht, dass die Winsock-DLL geladen wird.

Windows Phone 8: Diese Funktion wird für Windows Phone Store-Apps ab Windows Phone 8 unterstützt.

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 winsock2.h
Bibliothek Ws2_32.lib
DLL Ws2_32.dll

Weitere Informationen

InetNtop

WSAHtons

WSANtohl

WSANtohs

Winsock-Funktionen

Winsock-Referenz

htonl

htons

inet_addr

inet_ntoa

ntohl

ntohs