WSANtohs-Funktion (winsock2.h)

Artikel
03/13/2024

Die WSANtohs-Funktion konvertiert eine u_short aus der Netzwerkbytereihenfolge in die Hostbytereihenfolge.

Syntax

int WSAAPI WSANtohs(
  [in]  SOCKET  s,
  [in]  u_short netshort,
  [out] u_short *lphostshort
);

Parameter

[in] s

Ein Deskriptor, der einen Socket identifiziert.

[in] netshort

Eine 16-Bit-Zahl in Netzwerkbytereihenfolge.

[out] lphostshort

Ein Zeiger auf eine 16-Bit-Zahl, um die Nummer in Hostbytereihenfolge zu empfangen.

Rückgabewert

Wenn kein Fehler auftritt, gibt WSANtohs 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	Beim Netzwerksubsystem ist ein Fehler aufgetreten.
WSAENOTSOCK	Der Deskriptor ist kein Socket.
WSAEFAULT	Der lphostshort-Parameter ist NULL , oder die Adresse, auf die verwiesen wird, ist nicht vollständig in einem gültigen Teil des Benutzeradressraums enthalten.

Hinweise

Die WSANtohs-Funktion nimmt eine 16-Bit-Zahl in Netzwerkbytereihenfolge an und gibt eine 16-Bit-Zahl in Hostbytereihenfolge in der 16-Bit-Zahl zurück, auf die der lphostshort-Parameter verweist. Der im s-Parameter übergebene Socket 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 Netzwerkbytereihenfolgen verwenden.

Wenn der Socket für die AF_INET- oder AF_INET6 Adressfamilie ist, kann die WSANtohs-Funktion verwendet werden, um eine IP-Portnummer in Netzwerkbytereihenfolge in die IP-Portnummer in Hostbytereihenfolge zu konvertieren.

Die WSANtohs-Funktion erfordert, dass die Winsock-DLL zuvor mit einem erfolgreichen Aufruf der WSAStartup-Funktion geladen wurde. Für die Verwendung mit der AF_INET OR AF_INET6 Adressfamilie erfordert die ntohs-Funktion nicht, dass die Winsock-DLL geladen wird.

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 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