Функция WsCreateServiceHost (webservices.h)

Статья
08/27/2023

Создает узел службы для указанных конечных точек.

Синтаксис

HRESULT WsCreateServiceHost(
                 const WS_SERVICE_ENDPOINT **endpoints,
  [in]           const USHORT              endpointCount,
                 const WS_SERVICE_PROPERTY *serviceProperties,
  [in]           ULONG                     servicePropertyCount,
                 WS_SERVICE_HOST           **serviceHost,
  [in, optional] WS_ERROR                  *error
);

Параметры

endpoints

Массив WS_SERVICE_ENDPOINT структур, представляющих конечные точки службы, для которых создается узел службы.

[in] endpointCount

Количество конечных точек в массиве конечных точек .

serviceProperties

Массив WS_SERVICE_PROPERTY структур, содержащих необязательные свойства для узла службы.

Этот параметр может иметь значение NULL. В этом случае параметр servicePropertyCount должен иметь значение 0 (ноль).

[in] servicePropertyCount

Количество свойств в массиве serviceProperties .

serviceHost

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

Если эта структура больше не нужна, ее необходимо освободить, вызвав WsFreeServiceHost.

[in, optional] error

Указатель на структуру WS_ERROR , которая получает дополнительные сведения об ошибке в случае сбоя функции.

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

Если функция завершается успешно, она возвращает NO_ERROR; в противном случае возвращается код ошибки HRESULT.

Код возврата	Описание
E_INVALIDARG	Для создания узла службы указан недопустимый аргумент.
WS_E_QUOTA_EXCEEDED	Превышена квота.
E_OUTOFMEMORY	Недостаточно памяти для завершения операции.
Другие ошибки	Эта функция может возвращать другие ошибки, не перечисленные выше.

Требования

Требование	Значение
Минимальная версия клиента	Windows 7 [только классические приложения]
Минимальная версия сервера	Windows Server 2008 R2 [только классические приложения]
Целевая платформа	Windows
Header	webservices.h
Библиотека	WebServices.lib
DLL	WebServices.dll

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