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

Статья
08/27/2023

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

Синтаксис

INT WSAAPI WSAInstallServiceClassA(
  [in] LPWSASERVICECLASSINFOA lpServiceClassInfo
);

Параметры

[in] lpServiceClassInfo

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

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

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

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

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

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

Требования


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