Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Die WSAHtons-Funktion konvertiert einen u_short von der Hostbytereihenfolge in die Netzwerkbytereihenfolge.
Syntax
int WSAAPI WSAHtons(
[in] SOCKET s,
[in] u_short hostshort,
[out] u_short *lpnetshort
);
Parameter
[in] s
Ein Deskriptor, der einen Socket identifiziert.
[in] hostshort
Eine 16-Bit-Zahl in Hostbytereihenfolge.
[out] lpnetshort
Ein Zeiger auf einen 16-Bit-Puffer, um die Zahl in der Netzwerkbytereihenfolge zu empfangen.
Rückgabewert
Wenn kein Fehler auftritt, gibt WSAHtons null zurück. Andernfalls wird der Wert SOCKET_ERROR zurückgegeben, und ein bestimmter Fehlercode kann durch Aufrufen von WSAGetLastError abgerufen werden.
| Fehlercode | Bedeutung |
|---|---|
| Vor der Verwendung dieser Funktion muss ein erfolgreicher WSAStartup-Aufruf erfolgen. | |
| Fehler beim Netzwerksubsystem. | |
| Der Deskriptor ist kein Socket. | |
| Der lpnetshort-Parameter ist NULL , oder die Adresse, auf die verwiesen wird, ist nicht vollständig in einem gültigen Teil des Benutzeradressraums enthalten. |
Hinweise
Die WSAHtons-Funktion akzeptiert eine 16-Bit-Zahl in Hostbytereihenfolge und gibt eine 16-Bit-Zahl in Netzwerkbytereihenfolge in der 16-Bit-Zahl zurück, auf die der lpnetshort-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 WSAHtons-Funktion verwendet werden, um eine IP-Portnummer in Hostbytereihenfolge in die IP-Portnummer in Netzwerkbytereihenfolge zu konvertieren.
Die WSAHtons-Funktion erfordert, dass die Winsock-DLL zuvor mit einem erfolgreichen Aufruf der WSAStartup-Funktion geladen wurde. Für die Verwendung mit der adressfamilie AF_INET OR AF_INET6 erfordert die htons-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 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 |