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

Статья
08/27/2023

Используется прокси-сервером службы для форматирования указанных аргументов в соответствии с указанными метаданными и отправки их в сообщении. Приложение никогда не должно вызывать эту функцию напрямую.

Синтаксис

HRESULT WsCall(
  [in]           WS_SERVICE_PROXY               *serviceProxy,
  [in]           const WS_OPERATION_DESCRIPTION *operation,
  [in, optional] const void                     **arguments,
  [in]           WS_HEAP                        *heap,
                 const WS_CALL_PROPERTY         *callProperties,
  [in]           const ULONG                    callPropertyCount,
  [in, optional] const WS_ASYNC_CONTEXT         *asyncContext,
  [in, optional] WS_ERROR                       *error
);

Параметры

[in] serviceProxy

Указатель на структуру WS_SERVICE_PROXY, представляющую прокси-сервер службы.

[in] operation

Указатель на структуру WS_OPERATION_DESCRIPTION , содержащую метаданные для вызова.

[in, optional] arguments

Массив указателей на отдельные аргументы для операции службы, представленной параметром operation .

Количество элементов должно соответствовать количеству параметров, указанных в WS_OPERATION_DESCRIPTION в параметре операции.

[in] heap

Указатель на WS_HEAP структуру, представляющую кучу , из которой выделяется память для вызова.

callProperties

Массив WS_CALL_PROPERTY структур, содержащих свойства вызова.

[in] callPropertyCount

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

[in, optional] asyncContext

Указатель на сведения для асинхронного вызова функции. Передайте значение NULL для синхронного вызова функции.

[in, optional] error

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

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

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

Код возврата	Описание
WS_E_INVALID_OPERATION	Операция не разрешена из-за текущего состояния объекта .
WS_E_QUOTA_EXCEEDED	Превышена квота.
WS_E_OPERATION_ABANDONED	Операция была прекращена.
WS_E_OPERATION_TIMED_OUT	Операция не была завершена в отведенное время.
E_OUTOFMEMORY	Недостаточно памяти для завершения операции.
E_INVALIDARG	Один или несколько аргументов являются недопустимыми.
WS_S_ASYNC	Асинхронная операция по-прежнему находится в состоянии ожидания.
Другие ошибки	Эта функция может возвращать другие ошибки, не перечисленные выше.

Требования

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

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