Функция WSAGetServiceClassNameByClassIdA (winsock2.h)

Статья
11/20/2024

Функция WSAGetServiceClassNameByClassId извлекает имя службы, связанной с указанным типом. Это универсальное имя службы, например FTP или SNA, а не имя конкретного экземпляра этой службы.

Синтаксис

INT WSAAPI WSAGetServiceClassNameByClassIdA(
  [in]      LPGUID  lpServiceClassId,
  [out]     LPSTR   lpszServiceClassName,
  [in, out] LPDWORD lpdwBufferLength
);

Параметры

[in] lpServiceClassId

Указатель на GUID для класса службы.

[out] lpszServiceClassName

Указатель на имя службы.

[in, out] lpdwBufferLength

Длина буфера, возвращаемая lpszServiceClassName, в символах. В выходных данных длина имени службы, скопированная в lpszServiceClassName, в символах.

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

Функция WSAGetServiceClassNameByClassId возвращает значение нуля при успешном выполнении. В противном случае возвращается значение SOCKET_ERROR, а определенный номер ошибки можно получить путем вызова WSAGetLastError.

Код ошибки	Значение
WSA_INVALID_PARAMETER	Указан недопустимый параметр lpServiceClassId.
WSA_NOT_ENOUGH_MEMORY	Для выполнения операции недостаточно памяти.
WSAEACCES	Подпрограмма вызова не имеет достаточных привилегий для доступа к информации.
WSAEFAULT	Указанный буфер, на который указывает lpszServiceClassName, слишком мал. Передайте больший буфер.
WSAENOBUFS	Буферное пространство недоступно.
WSAEOPNOTSUPP	Операция не поддерживается для типа объекта, на который ссылается ссылка. Эта ошибка возвращается некоторыми поставщиками пространств имен, которые не поддерживают получение сведений о классе службы.
WSANO_DATA	Допустимый lpServiceClassId, но данные запрошенного типа не найдены.
WSANOTINITIALISED	WS2_32.DLL не инициализирована. Приложение должно сначала вызвать WSAStartup перед вызовом функций сокетов Windows.

Замечания

Заметка

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

Требования

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

См. также

WSAStartup

Функции Winsock

Справочник Winsock

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