Compartilhar via

Função WsCreateListener (webservices.h)

  • Artigo

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
WS_E_QUOTA_EXCEEDED
 Uma cota foi excedida.
E_OUTOFMEMORY
 Memória insuficiente para concluir a operação.
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 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
(Consulte a enumeração WS_LISTENER_PROPERTY_ID .) Se outras propriedades iniciais forem necessárias para criar o ouvinte personalizado, especifique-as usando a propriedade 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