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

Статья
11/20/2024

Функция WSAInstallServiceClass регистрирует схему класса службы в пространстве имен. Эта схема включает имя класса, идентификатор класса и все сведения, относящиеся к пространству имен, общие для всех экземпляров службы, например идентификатор SAP или идентификатор объекта.

Синтаксис

INT WSAAPI WSAInstallServiceClassA(
  [in] LPWSASERVICECLASSINFOA lpServiceClassInfo
);

Параметры

[in] lpServiceClassInfo

Класс службы для сведений о сопоставлении конкретных типов с пространством имен. Одновременно можно обрабатывать несколько сопоставлений.

В разделе Структуры данных класса службы описание соответствующих структур данных.

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

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

Код ошибки	Значение
WSA_INVALID_PARAMETER	Поставщик пространства имен не может указать запрошенные сведения о классе.
WSA_NOT_ENOUGH_MEMORY	Для выполнения операции недостаточно памяти.
WSAEACCES	Вызывающая функция не имеет достаточных привилегий для установки службы.
WSAEALREADY	Сведения о классе службы уже зарегистрированы для этого идентификатора класса службы. Чтобы изменить сведения о классе службы, сначала используйте WSARemoveServiceClass, а затем переустановите обновленные данные сведений о классе.
WSAEINVAL	Сведения о классе службы не были допустимыми или неправильно структурированы. Эта ошибка возвращается, если параметр lpServiceClassInfoNULL.
WSAEOPNOTSUPP	Операция не поддерживается. Эта ошибка возвращается, если поставщик пространства имен не реализует эту функцию.
WSANO_DATA	Запрошенное имя допустимо, но данные запрошенного типа не найдены.
WSANOTINITIALISED	WS2_32.DLL не инициализирована. Приложение должно сначала вызвать WSAStartup перед вызовом функций сокетов Windows.

Замечания

Заметка

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

Требования

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

См. также

WSAGetLastError

WSAGetServiceClassInfo

WSASERVICECLASSINFO

Функции Winsock

Справочник Winsock

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