Función WsCall (webservices.h)

Usado internamente por el proxy de servicio para dar formato a los argumentos especificados según los metadatos especificados y enviarlos en un mensaje. La aplicación nunca debe llamar a esta función directamente.

Sintaxis

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
);

Parámetros

[in] serviceProxy

Puntero a una estructura WS_SERVICE_PROXY que representa el proxy de servicio.

[in] operation

Puntero a una estructura de WS_OPERATION_DESCRIPTION que contiene los metadatos de la llamada.

[in, optional] arguments

Matriz de punteros a los argumentos individuales de la operación de servicio representada por el parámetro operation .

El número de elementos debe corresponder al número de parámetros especificados como parte de WS_OPERATION_DESCRIPTION en el parámetro operation.

[in] heap

Puntero a una estructura WS_HEAP que representa el montón desde el que se asigna memoria para la llamada.

callProperties

Matriz de estructuras de WS_CALL_PROPERTY que contienen las propiedades de llamada.

[in] callPropertyCount

Número de propiedades de la matriz de propiedades de llamada.

[in, optional] asyncContext

Puntero a la información para invocar la función de forma asincrónica. Pase NULL para invocar la función de forma sincrónica.

[in, optional] error

Puntero a una estructura de WS_ERROR que recibe información de error adicional si se produce un error en la función.

Valor devuelto

Si la función se realiza correctamente, devuelve NO_ERROR; de lo contrario, devuelve un código de error HRESULT.

Código devuelto Descripción
WS_E_INVALID_OPERATION
No se permite la operación debido al estado actual del objeto .
WS_E_QUOTA_EXCEEDED
Se superó una cuota.
WS_E_OPERATION_ABANDONED
La operación fue abandonada.
WS_E_OPERATION_TIMED_OUT
La operación no se completó dentro del tiempo asignado.
E_OUTOFMEMORY
Memoria insuficiente para completar la operación.
E_INVALIDARG
Uno o más argumentos no son válidos.
WS_S_ASYNC
La operación asincrónica sigue pendiente.
Otros errores
Esta función puede devolver otros errores no enumerados anteriormente.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 7 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2008 R2 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino Windows
Encabezado webservices.h
Library WebServices.lib
Archivo DLL WebServices.dll