Поделиться через


Функция WSANtohs (winsock2.h)

Функция WSANtohs преобразует u_short из порядка байтов сети в порядок байтов узла.

Синтаксис

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

Параметры

[in] s

Дескриптор, определяющий сокет.

[in] netshort

16-разрядное число в сетевом порядке байтов.

[out] lphostshort

Указатель на 16-разрядное число для получения номера в порядке байтов узла.

Возвращаемое значение

Если ошибка не возникает, WSANtohs возвращает ноль. В противном случае возвращается значение SOCKET_ERROR, а определенный код ошибки можно получить, вызвав WSAGetLastError.

Код ошибки Значение
WSANOTINITIALISED
Перед использованием этой функции должен произойти успешный вызов WSAStartup .
WSAENETDOWN
Произошел сбой сетевой подсистемы.
WSAENOTSOCK
Дескриптор не является сокетом.
WSAEFAULT
Параметр lphostshort имеет значение NULL или адрес, на который указывает, не полностью содержится в допустимой части адресного пространства пользователя.

Комментарии

Функция WSANtohs принимает 16-разрядное число в сетевом порядке байтов и возвращает 16-битовое число в порядке байтов узла в 16-разрядном номере, на которое указывает параметр lphostshort . Сокет, переданный в параметре s, используется для определения требуемого порядка сетевых байтов на основе записи протокола каталога Winsock, связанной с сокетом. Эта функция поддерживает поставщиков Winsock, которые используют различные сетевые заказы байтов.

Если сокет предназначен для семейства AF_INET или AF_INET6 адресов, функция WSANtohs может использоваться для преобразования номера IP-порта в сетевом байтовом порядке в номер IP-порта в порядке байтов узла.

Для функции WSANtohs требуется, чтобы библиотека DLL Winsock была загружена ранее с успешным вызовом функции WSAStartup . Для использования с семейством адресов AF_INET OR AF_INET6 функция ntohs не требует загрузки библиотеки DLL Winsock.

Windows Phone 8. Эта функция поддерживается для приложений Магазина Windows Phone на Windows Phone 8 и более поздних версиях.

Windows 8.1 и Windows Server 2012 R2. Эта функция поддерживается для приложений Магазина Windows на Windows 8.1, Windows Server 2012 R2 и более поздних версиях.

Требования

Требование Значение
Минимальная версия клиента Windows 8.1, Windows Vista [классические приложения | Приложения UWP]
Минимальная версия сервера Windows Server 2003 [классические приложения | Приложения UWP]
Целевая платформа Windows
Header winsock2.h
Библиотека Ws2_32.lib
DLL Ws2_32.dll

См. также раздел

InetNtop

WSAHtonl

WSAHtons

WSANtohl

Функции Winsock

Справочник по Winsock

htonl

htons

inet_addr

inet_ntoa

ntohl

ntohs