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

Функция обратного вызова LPNSPINSTALLSERVICECLASS (ws2spi.h)

  • Статья

Функция NSPInstallServiceClass регистрирует схему класса службы в поставщиках пространства имен.

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

Синтаксис

LPNSPINSTALLSERVICECLASS Lpnspinstallserviceclass;

INT Lpnspinstallserviceclass(
  [in] LPGUID lpProviderId,
  [in] LPWSASERVICECLASSINFOW lpServiceClassInfo
)
{...}

Параметры

[in] lpProviderId

Указатель на GUID конкретного поставщика пространства имен, в который зарегистрирована схема класса службы.

[in] lpServiceClassInfo

Указатель на сведения о схеме класса службы.

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

Функция должна возвращать NO_ERROR (ноль), если подпрограмма выполнена успешно. Он должен возвращать SOCKET_ERROR (–1), если подпрограмма завершается сбоем, и он должен задать соответствующий код ошибки с помощью WSASetLastError.

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

Комментарии

Поставщикам пространств имен рекомендуется, но не требуется хранить сведения, относящиеся к поддерживаемой ими пространству имен.

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header ws2spi.h

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

NSPGetServiceClassInfo

NSPRemoveServiceClass

WSASERVICECLASSINFOW

WSASetLastError