Função WsOpenListener (webservices.h)

Inicia a "escuta" em um endereço especificado. Depois que um ouvinte é aberto, os canais podem ser aceitos dele. Se a abertura for bem-sucedida, o Ouvinte deverá ser fechado usando a função WsCloseListener antes que os recursos do Ouvinte possam ser liberados.

Sintaxe

HRESULT WsOpenListener(
  [in]           WS_LISTENER            *listener,
  [in]           const WS_STRING        *url,
  [in, optional] const WS_ASYNC_CONTEXT *asyncContext,
  [in, optional] WS_ERROR               *error
);

Parâmetros

[in] listener

Um ponteiro para o objeto Listener a ser aberto. O ponteiro deve referenciar um objeto WS_LISTENER válido e o valor referenciado pode não ser NULL.

[in] url

Um ponteiro para um objeto que contém a cadeia de caracteres de endereço de URL para o Ouvinte.

Nota A URL está sempre em formato de escape.. A URL pode não conter uma cadeia de caracteres de consulta ou fragmento. Essa URL pode incluir os caracteres curinga '+' ou '*' na parte do nome do host, um nome de host ou um endereço IP literal. Consulte Comentários para obter mais informações sobre a URL.

 

[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 ouvinte foi anulado durante a abertura ou antes da abertura.
WS_E_INVALID_OPERATION	O ouvinte está no estado incorreto.
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 este 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

Ao usar endereços IPv6, eles devem ser colocados entre colchetes na parte do nome do host.

Para obter mais informações, consulte WS_HTTP_CHANNEL_BINDING.

Para WS_UDP_CHANNEL_BINDING, a parte do caminho da URL é ignorada. Se um endereço IP literal for especificado, ele será usado para escutar; caso contrário, um endereço IP curinga será usado.

Para WS_TCP_CHANNEL_BINDING, a parte do caminho da URL é correspondida como um prefixo em relação à URL recebida.
Se um endereço IP literal for especificado, ele será usado para escutar; caso contrário, um endereço IP curinga será usado.

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