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

  • Статья

Функция 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 или Юникод этой функции на основе определения константы препроцессора UNICODE. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

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

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

WSAStartup

Функции Winsock

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