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

Статья
11/20/2024

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

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

Синтаксис

INT GetTypeByNameW(
  [in]      LPWSTR lpServiceName,
  [in, out] LPGUID lpServiceType
);

Параметры

[in] lpServiceName

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

[in, out] lpServiceType

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

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

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

Если функция выполнена успешно, возвращаемое значение равно нулю.

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

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

Замечания

Заметка

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

Требования

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

См. также

GetNameByType

Функции Winsock

Справочник Winsock

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