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


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

Функция 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