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.
HRESULT WsOpenServiceHost(
[in] WS_SERVICE_HOST *serviceHost,
[in, optional] const WS_ASYNC_CONTEXT *asyncContext,
[in, optional] WS_ERROR *error
);
[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.
Essa função pode retornar um desses valores.
Código de retorno | Descrição |
---|---|
|
A operação assíncrona ainda está pendente. |
|
O host de serviço foi anulado antes da abertura ou durante a abertura. |
|
O estado atual do proxy de serviço não é válido para essa operação. |
|
O endereço já está sendo usado. |
|
O endereço não é válido para esse contexto. |
|
Uma cota foi excedida. |
|
A operação foi anulada. |
|
A operação não foi concluída dentro do tempo alocado. |
|
Ficou sem memória. |
|
Um ou mais argumentos são inválidos. |
|
Essa função pode retornar outros erros não listados acima. |
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.
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 |