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

  • Статья
  • Чтение занимает 2 мин

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

Синтаксис

INT WSAAPI WSAGetServiceClassNameByClassIdW(
  [in]      LPGUID  lpServiceClassId,
  [out]     LPWSTR  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]
Целевая платформа Windows
Header winsock2.h
Библиотека Ws2_32.lib
DLL Ws2_32.dll

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

WSAStartup

Функции Winsock

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