Função WsCloseServiceHost (webservices.h)
Fecha a comunicação com o host de serviço especificado.
Sintaxe
HRESULT WsCloseServiceHost(
[in] WS_SERVICE_HOST *serviceHost,
[in, optional] const WS_ASYNC_CONTEXT *asyncContext,
[in, optional] WS_ERROR *error
);
Parâmetros
[in] serviceHost
Ponteiro para uma estrutura de WS_SERVICE_HOST que representa o host 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.
Retornar valor
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 |
|---|---|
|
A operação assíncrona ainda está pendente. |
|
O estado atual do host de serviço não é válido para esta operação. |
|
Um ou mais argumentos são inválidos. |
|
A operação não foi concluída dentro do tempo alocado. |
|
A operação foi anulada. |
|
Essa função pode retornar outros erros não listados acima. |
Comentários
O WsCloseServiceHost fecha todos os ouvintes no host do serviço. Como resultado, nenhum novo canais é aceito do cliente. No entanto, a E/S pendente em canais já aceitos tem permissão para ser concluída.
Isso tem implicações para pontos de extremidade configurados para serem executados com associações de canal baseadas em sessão. Se um cliente tiver uma sessão aberta com um serviço nesse ponto de extremidade, o fechamento não será concluído até que o cliente feche a sessão com o serviço.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 7 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2008 R2 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | webservices.h |
| Biblioteca | WebServices.lib |
| DLL | WebServices.dll |