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

Статья
03/13/2024

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

Синтаксис

servent * getservbyname(
  [in] const char *name,
  [in] const char *proto
);

Параметры

[in] name

Указатель на имя службы, завершаемое null.

[in] proto

Указатель на имя протокола, завершаемого null. Если этот указатель имеет значение NULL, функция getservbyname возвращает первую запись службы, имя которой соответствует s_nameэлементу структуры обслуживания или s_aliases элементу структуры обслуживания . В противном случае getservbyname соответствует имени и proto.

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

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

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

Функция getservbyname возвращает указатель на структуру обслуживания , содержащую имена и номера службы, соответствующие строке в параметре name . Все строки заканчиваются значением NULL.

Возвращаемый указатель указывает на структуру обслуживания , выделенную библиотекой сокетов 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

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

WSAsyncGetServByName

Функции Winsock

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

getservbyport

Share via