Função WsOpenServiceHost (webservices.h)

Abre um Host de Serviço para comunicação e inicia os Ouvintes em todos os pontos de extremidade. Os aplicativos cliente não podem se conectar aos pontos de extremidade de serviço até que WsOpenSerivceHost seja chamado.

Sintaxe

HRESULT WsOpenServiceHost(
  [in]           WS_SERVICE_HOST        *serviceHost,
  [in, optional] const WS_ASYNC_CONTEXT *asyncContext,
  [in, optional] WS_ERROR               *error
);

Parâmetros

[in] serviceHost

Um ponteiro para o objeto Host de Serviço a ser aberto. O ponteiro deve referenciar um objeto WS_SERVICE_HOST válido retornado por WsCreateServiceHost e o valor do Host de Serviço referenciado pode não ser NULL.

[in, optional] asyncContext

Um ponteiro para um objeto WS_ASYNC_CONTEXT que tem informações sobre como invocar a função de forma assíncrona. O valor será definido como NULL se invocar de forma síncrona.

[in, optional] error

Um ponteiro para um objeto WS_ERROR em que informações adicionais sobre o erro devem ser armazenadas se a função falhar.

Retornar valor

Essa função pode retornar um desses valores.

Código de retorno Descrição
WS_S_ASYNC
A operação assíncrona ainda está pendente.
WS_E_OPERATION_ABORTED
O host de serviço foi anulado antes da abertura ou durante a abertura.
WS_E_INVALID_OPERATION
O estado atual do proxy de serviço não é válido para essa operação.
WS_E_ADDRESS_IN_USE
O endereço já está sendo usado.
WS_E_ADDRESS_NOT_AVAILABLE
O endereço não é válido para esse contexto.
WS_E_QUOTA_EXCEEDED
Uma cota foi excedida.
WS_E_OPERATION_ABORTED
A operação foi anulada.
WS_E_OPERATION_TIMED_OUT
A operação não foi concluída dentro do tempo alocado.
E_OUTOFMEMORY
Ficou sem memória.
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

Observe que todos os ouvintes de pontos de extremidade precisam ser abertos com êxito antes que qualquer canal seja aceito pelo host de serviço para se comunicar com o cliente.

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