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

Статья
11/20/2024

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

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

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

Синтаксис

INT GetNameByTypeW(
  [in]  LPGUID lpServiceType,
  [out] LPWSTR 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 или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	nspapi.h
библиотеки	Mswsock.lib
DLL	Mswsock.dll

См. также

GetTypeByName

Функции Winsock

Справочник Winsock

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