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 WSANtohl-Funktion konvertiert eine u_long von der Netzwerkbytereihenfolge in die Hostbytereihenfolge.
Syntax
int WSAAPI WSANtohl(
[in] SOCKET s,
[in] u_long netlong,
[out] u_long *lphostlong
);
Parameter
[in] s
Ein Deskriptor, der einen Socket identifiziert.
[in] netlong
Eine 32-Bit-Zahl in Netzwerkbytereihenfolge.
[out] lphostlong
Ein Zeiger auf eine 32-Bit-Zahl, um die Zahl in Hostbytereihenfolge zu empfangen.
Rückgabewert
Wenn kein Fehler auftritt, gibt WSANtohl 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 lphostlong-Parameter ist NULL , oder die Adresse, auf die verwiesen wird, ist nicht vollständig in einem gültigen Teil des Benutzeradressraums enthalten. |
Hinweise
Die WSANtohl-Funktion akzeptiert eine 32-Bit-Zahl in Netzwerkbytereihenfolge und gibt eine 32-Bit-Zahl in Hostbytereihenfolge in der 32-Bit-Zahl zurück, auf die der lphostlong-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 WSANtohl-Funktion verwendet werden, um eine IPv4-Adresse in Netzwerkbytereihenfolge in die IPv4-Adresse in Hostbytereihenfolge zu konvertieren. Diese Funktion führt keine Überprüfung durch, um festzustellen, ob der netlong-Parameter eine gültige IPv4-Adresse ist.
Die WSANtohl-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 ntohl-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 |