Função WsCloseServiceProxy (webservices.h)

Fecha a comunicação com o proxy de serviço especificado.

Sintaxe

HRESULT WsCloseServiceProxy(
  [in]           WS_SERVICE_PROXY       *serviceProxy,
  [in, optional] const WS_ASYNC_CONTEXT *asyncContext,
  [in, optional] WS_ERROR               *error
);

Parâmetros

[in] serviceProxy

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

[in, optional] asyncContext

Ponteiro para uma estrutura WS_ASYNC_CONTEXT que contém 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 WS_ERROR que recebe informações de erro adicionais se a função falhar.

Valor retornado

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

Código de retorno	Descrição
WS_S_ASYNC	A operação assíncrona ainda está pendente.
WS_E_INVALID_OPERATION	O estado atual do proxy de serviço não é válido para esta operação. Esse é apenas um erro para o qual o fechamento falhará.
WS_E_ENDPOINT_DISCONNECTED	O WS_CHANNEL subjacente foi desconectado durante a operação de fechamento. Esse erro ocorre somente nos casos em que o canal subjacente é baseado em sessão.
WS_E_OPERATION_ABORTED	A operação foi anulada.
WS_E_ENDPOINT_FAILURE	O ponto de extremidade remoto não pôde processar a solicitação.
WS_E_INVALID_FORMAT	Os dados de entrada não estavam no formato esperado ou não tinham o valor esperado.
WS_E_OPERATION_TIMED_OUT	A operação não foi concluída dentro do tempo alocado.
WS_E_QUOTA_EXCEEDED	Uma cota foi excedida.
E_OUTOFMEMORY	Memória insuficiente para concluir a operação.
E_INVALIDARG	Um ou mais argumentos são inválidos.
Outros erros	Essa função pode retornar outros erros não listados acima.

Comentários

Se uma chamada de operação de serviço estiver pendente no proxy de serviço, WsCloseServiceProxy aguardará a conclusão de cada chamada. Depois de chamar o aplicativo WsCloseServiceProxy , não deve executar mais chamadas no proxy de serviço.

Observe que WS_E_INVALID_OPERATION é o único
código de erro que indica que o fechamento falhou. Outros códigos de erro indicam que a operação foi bem-sucedida e o código de erro é apenas para fins informativos.

Requisitos

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