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

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

  • Статья

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

Синтаксис

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