Функция WSAInstallServiceClassA (winsock2.h)
Функция WSAInstallServiceClass регистрирует схему класса службы в пространстве имен. Эта схема включает имя класса, идентификатор класса и все сведения, относящиеся к пространству имен, общие для всех экземпляров службы, такие как идентификатор SAP или идентификатор объекта.
Синтаксис
INT WSAAPI WSAInstallServiceClassA(
[in] LPWSASERVICECLASSINFOA lpServiceClassInfo
);
Параметры
[in] lpServiceClassInfo
Класс службы для сведений о сопоставлении конкретного типа пространства имен. Одновременно можно обрабатывать несколько сопоставлений.
Описание соответствующих структур данных см. в разделе Структуры данных класса служб .
Возвращаемое значение
Возвращаемое значение равно нулю, если операция прошла успешно. В противном случае возвращается значение SOCKET_ERROR, а определенный номер ошибки можно получить, вызвав WSAGetLastError.
| Код ошибки | Значение |
|---|---|
| Поставщик пространства имен не может предоставить запрошенные сведения о классе. | |
| Недостаточно памяти для выполнения операции. | |
| Вызывающая функция не имеет достаточных привилегий для установки службы. | |
| Сведения о классе службы уже зарегистрированы для этого идентификатора класса службы. Чтобы изменить сведения о классе службы, сначала используйте WSARemoveServiceClass, а затем переустановите с обновленными данными о классе. | |
| Сведения о классе службы не были допустимыми или неправильно структурированы. Эта ошибка возвращается, если параметр lpServiceClassInfo имеет значение NULL. | |
| Операция не поддерживается. Эта ошибка возвращается, если поставщик пространства имен не реализует эту функцию. | |
| Запрошенное имя является допустимым, но данные запрошенного типа не найдены. | |
| 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 |