Função WsCreateListener (webservices.h)
Cria um ouvinte com as propriedades especificadas.
Sintaxe
HRESULT WsCreateListener(
[in] WS_CHANNEL_TYPE channelType,
[in] WS_CHANNEL_BINDING channelBinding,
const WS_LISTENER_PROPERTY *properties,
[in] ULONG propertyCount,
[in, optional] const WS_SECURITY_DESCRIPTION *securityDescription,
WS_LISTENER **listener,
[in, optional] WS_ERROR *error
);
Parâmetros
[in] channelType
O tipo de canal que o ouvinte escuta. Para tipos de canal, consulte a enumeração WS_CHANNEL_TYPE .
[in] channelBinding
O protocolo de canal para o ouvinte. Para possíveis associações, consulte a enumeração WS_CHANNEL_BINDING .
properties
Ponteiro para uma estrutura de WS_LISTENER_PROPERTY que contém propriedades opcionais para o ouvinte.
Para obter informações sobre quais propriedades você pode especificar ao criar um ouvinte, consulte a enumeração WS_LISTENER_PROPERTY_ID .
Para obter informações sobre como criar um ouvinte personalizado, consulte a seção Comentários.
[in] propertyCount
O número de propriedades na matriz de propriedades .
[in, optional] securityDescription
Ponteiro para uma estrutura de WS_SECURITY_DESCRIPTION especificando a segurança do ouvinte.
Se você estiver criando um canal personalizado (usando o valor WS_CUSTOM_CHANNEL_BINDING da enumeração WS_CHANNEL_BINDING ), a descrição de segurança deverá ser NULL. Consulte a seção Comentários.
listener
Em caso de êxito, um ponteiro que recebe o endereço da estrutura WS_LISTENER que representa o novo ouvinte.
[in, optional] error
Ponteiro para uma estrutura de 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 retorna um código de erro HRESULT.
Código de retorno | Descrição |
---|---|
|
Uma cota foi excedida. |
|
Memória insuficiente para concluir a operação. |
|
Um ou mais argumentos são inválidos. |
|
Essa função pode retornar outros erros não listados acima. |
Comentários
Ao criar um ouvinte personalizado (usando o valor WS_CUSTOM_CHANNEL_BINDING da enumeração WS_CHANNEL_BINDING ), você pode especificar apenas as seguintes propriedades de canal:
- WS_LISTENER_PROPERTY_CUSTOM_LISTENER_CALLBACKS
- WS_LISTENER_PROPERTY_CUSTOM_LISTENER_PARAMETERS
Para passar informações de segurança para uma implementação de ouvinte personalizada, use o valor WS_LISTENER_PROPERTY_CUSTOM_LISTENER_PARAMETERS da enumeração WS_LISTENER_PROPERTY_ID .
Requisitos
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 |