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

Статья
03/05/2024

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

Примечание Функция GetTypeByName — это специальное расширение корпорации Майкрософт для спецификации Windows Sockets 1.1. Эта функция является устаревшей. Для удобства разработчиков Windows Sockets 1.1 этот справочный материал включен. Функции, описанные в разделе Разрешение имен, независимых от протокола , предоставляют эквивалентные функции в сокетах Windows 2.

Синтаксис

INT GetTypeByNameA(
  [in]      LPSTR  lpServiceName,
  [in, out] LPGUID lpServiceType
);

Параметры

[in] lpServiceName

Указатель на строку с нулем, которая уникально представляет имя службы. Например, "MY SNA SERVER".

[in, out] lpServiceType

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

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

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

Если вызов функции заканчивается удачно, возвращается нулевое значение.

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

Значение	Значение
ERROR_SERVICE_DOES_NOT_EXIST	Указанный тип службы неизвестен.

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

Требования

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

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

GetNameByType

Функции Winsock

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

Share via