Compartilhar via

Função WsCloseServiceProxy (webservices.h)

  • Artigo

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