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

Функция getprotobynumber (winsock.h)

  • Статья

Функция getprotobynumber извлекает сведения о протоколе, соответствующие номеру протокола.

Синтаксис

protoent * getprotobynumber(
  int proto
);

Параметры

proto

TBD

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

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

Код ошибки Значение
WSANOTINITIALISED
 Перед использованием этой функции должен быть выполнен успешный вызов WSAStartup .
WSAENETDOWN
 Произошел сбой сетевой подсистемы.
WSAHOST_NOT_FOUND
 Достоверный протокол ответа не найден.
WSATRY_AGAIN
 Неавторитационный протокол не найден или сбой сервера.
WSANO_RECOVERY
 Неустранимые ошибки, база данных протоколов недоступна.
WSANO_DATA
 Допустимое имя, нет записи данных запрошенного типа.
WSAEINPROGRESS
 Выполняется блокирующий вызов Windows Sockets 1.1 или поставщик услуг по-прежнему обрабатывает функцию обратного вызова.
WSAEINTR
 Блокирующий вызов сокета Windows 1.1 был отменен через WSACancelBlockingCall.

Комментарии

Эта функция getprotobynumber возвращает указатель на структуру protoent , как описано ранее в getprotobyname. Содержимое структуры соответствует заданному номеру протокола.

Возвращаемый указатель указывает на структуру, выделенную сокетами Windows. Приложение никогда не должно пытаться изменить эту структуру или освободить какие-либо из ее компонентов. Кроме того, для каждого потока выделяется только одна копия этой структуры, поэтому приложение должно скопировать все необходимые сведения перед выполнением других вызовов функций Windows Sockets.

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 winsock.h (включая Winsock2.h)
Библиотека Ws2_32.lib
DLL Ws2_32.dll

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

WSAsyncGetProtoByNumber

Функции Winsock

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

getprotobyname