WSANtohl-Funktion (winsock2.h)
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 |