Функция GetNameByTypeA (nspapi.h)

Статья
03/05/2024

Функция GetNameByType извлекает имя сетевой службы для указанного типа службы.

Примечание Функция GetNameByType — это специальное расширение для спецификации Windows Sockets 1.1. Эта функция является устаревшей. Для удобства разработчиков Windows Sockets 1.1 справочные материалы приведены ниже.

Примечание Функции, описанные в разделе Разрешение имен, независимых от протокола , предоставляют эквивалентные функции в сокетах Windows 2.

Синтаксис

INT GetNameByTypeA(
  [in]  LPGUID lpServiceType,
  [out] LPSTR  lpServiceName,
  [in]  DWORD  dwNameLength
);

Параметры

[in] lpServiceType

Указатель на глобальный уникальный идентификатор (GUID), указывающий тип сетевой службы. Файл заголовка Svcguid.h содержит определения нескольких типов служб GUID и макросы для работы с ними.

Файл заголовка Svcguid.h не включается автоматически в файл заголовка Winsock2.h .

[out] lpServiceName

Указатель на буфер для получения строки, завершаемой с нуля, которая уникально представляет имя сетевой службы.

[in] dwNameLength

Указатель на переменную, которая на входных данных указывает размер буфера, на который указывает lpServiceName ( в байтах). В выходных данных переменная содержит фактический размер строки имени службы в байтах.

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

Если функция выполняется успешно, возвращаемое значение не SOCKET_ERROR (–1).

Если функция завершается сбоем, возвращается значение SOCKET_ERROR (–1). Дополнительные сведения об ошибке можно получить, вызвав GetLastError.

Заголовок nspapi.h определяет GetNameByType в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора UNICODE. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	nspapi.h
Библиотека	Mswsock.lib
DLL	Mswsock.dll

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

GetTypeByName

Функции Winsock

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

Share via