Função WsCall (webservices.h)

Usado internamente pelo proxy de serviço para formatar os argumentos especificados de acordo com os metadados especificados e enviá-los em uma mensagem. O aplicativo nunca deve chamar essa função diretamente.

Sintaxe

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

Ponteiro para uma estrutura de WS_SERVICE_PROXY que representa o proxy de serviço.

[in] operation

Ponteiro para uma estrutura WS_OPERATION_DESCRIPTION que contém os metadados da chamada.

[in, optional] arguments

Uma matriz de ponteiros para os argumentos individuais para a operação de serviço que está sendo representada pelo parâmetro de operação .

O número de elementos deve corresponder ao número de parâmetros especificados como parte de WS_OPERATION_DESCRIPTION no parâmetro de operação.

[in] heap

Ponteiro para uma estrutura WS_HEAP que representa o heap do qual a memória é alocada para a chamada.

callProperties

Uma matriz de estruturas de WS_CALL_PROPERTY que contém as propriedades de chamada.

[in] callPropertyCount

O número de propriedades na matriz de propriedades de chamada.

[in, optional] asyncContext

Ponteiro para informações para invocar a função de forma assíncrona. Passe NULL para invocar a função de forma síncrona.

[in, optional] error

Ponteiro para uma estrutura de WS_ERROR que recebe informações de erro adicionais se a função falhar.

Retornar valor

Se a função for bem-sucedida, ela retornará NO_ERROR; caso contrário, ele retorna um código de erro HRESULT.

Código de retorno	Descrição
WS_E_INVALID_OPERATION	A operação não é permitida devido ao estado atual do objeto.
WS_E_QUOTA_EXCEEDED	Uma cota foi excedida.
WS_E_OPERATION_ABANDONED	A operação foi abandonada.
WS_E_OPERATION_TIMED_OUT	A operação não foi concluída dentro do tempo alocado.
E_OUTOFMEMORY	Memória insuficiente para concluir a operação.
E_INVALIDARG	Um ou mais argumentos são inválidos.
WS_S_ASYNC	A operação assíncrona ainda está pendente.
Outros erros	Essa função pode retornar outros erros não listados acima.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 7 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2008 R2 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	webservices.h
Biblioteca	WebServices.lib
DLL	WebServices.dll