Compartilhar via

enumeração WS_SERVICE_ENDPOINT_PROPERTY_ID (webservices.h)

  • Artigo

Cada propriedade representa parâmetros opcionais para configurar a estrutura de WS_SERVICE_ENDPOINT fornecida. Essa enumeração é usada dentro da estrutura WS_SERVICE_ENDPOINT_PROPERTY que faz parte do WS_SERVICE_ENDPOINT.

Syntax

typedef enum {
  WS_SERVICE_ENDPOINT_PROPERTY_ACCEPT_CHANNEL_CALLBACK = 0,
  WS_SERVICE_ENDPOINT_PROPERTY_CLOSE_CHANNEL_CALLBACK = 1,
  WS_SERVICE_ENDPOINT_PROPERTY_MAX_ACCEPTING_CHANNELS = 2,
  WS_SERVICE_ENDPOINT_PROPERTY_MAX_CONCURRENCY = 3,
  WS_SERVICE_ENDPOINT_PROPERTY_BODY_HEAP_MAX_SIZE = 4,
  WS_SERVICE_ENDPOINT_PROPERTY_BODY_HEAP_TRIM_SIZE = 5,
  WS_SERVICE_ENDPOINT_PROPERTY_MESSAGE_PROPERTIES = 6,
  WS_SERVICE_ENDPOINT_PROPERTY_MAX_CALL_POOL_SIZE = 7,
  WS_SERVICE_ENDPOINT_PROPERTY_MAX_CHANNEL_POOL_SIZE = 8,
  WS_SERVICE_ENDPOINT_PROPERTY_LISTENER_PROPERTIES = 9,
  WS_SERVICE_ENDPOINT_PROPERTY_CHECK_MUST_UNDERSTAND = 10,
  WS_SERVICE_ENDPOINT_PROPERTY_METADATA_EXCHANGE_TYPE = 11,
  WS_SERVICE_ENDPOINT_PROPERTY_METADATA = 12,
  WS_SERVICE_ENDPOINT_PROPERTY_METADATA_EXCHANGE_URL_SUFFIX = 13,
  WS_SERVICE_ENDPOINT_PROPERTY_MAX_CHANNELS = 14
} WS_SERVICE_ENDPOINT_PROPERTY_ID;

Constantes

 
WS_SERVICE_ENDPOINT_PROPERTY_ACCEPT_CHANNEL_CALLBACK
Valor: 0
Usado com WS_SERVICE_ENDPOINT.
O valor é um ponteiro para WS_SERVICE_PROPERTY_ACCEPT_CALLBACK estrutura.
WS_SERVICE_ENDPOINT_PROPERTY_CLOSE_CHANNEL_CALLBACK
Valor: 1
Usado com WS_SERVICE_ENDPOINT.
O valor é um ponteiro para WS_SERVICE_PROPERTY_CLOSE_CALLBACK estrutura.
WS_SERVICE_ENDPOINT_PROPERTY_MAX_ACCEPTING_CHANNELS
Valor: 2
Usado com WS_SERVICE_ENDPOINT, isso especifica o número máximo de canais simultâneos que o host do serviço terá
aceitar ativamente novas conexões para um determinado ponto de extremidade. Quando não especificado, esse valor é definido como 1. Se um ponto de extremidade especificar um manipulador de mensagens padrão (consulte WS_SERVICE_ENDPOINT) simultaneidade
tem que ser 1.
WS_SERVICE_ENDPOINT_PROPERTY_MAX_CONCURRENCY
Valor: 3
Usado com WS_SERVICE_ENDPOINT, isso especifica o número máximo de chamadas simultâneas que seriam atendidas em um canal baseado em sessão.
Quando não especificado, esse valor é definido como 1. Se um ponto de extremidade especificar um manipulador de mensagens padrão (consulte simultaneidade WS_SERVICE_ENDPOINT
tem que ser 1.
WS_SERVICE_ENDPOINT_PROPERTY_BODY_HEAP_MAX_SIZE
Valor: 4
Tamanho máximo do heap para desserialização do corpo.


Essa é a configuração de heap disponível usada para desserializar o corpo. Esse heap também é
disponível para operações de serviço para alocar parâmetros.


O padrão é 65535 bytes.
WS_SERVICE_ENDPOINT_PROPERTY_BODY_HEAP_TRIM_SIZE
Valor: 5
Tamanho do corte de heap para desserialização do corpo.


Essa é a configuração de heap disponível usada para desserializar o corpo. Esse heap também é
disponível para operações de serviço para alocar parâmetros.


O padrão é 4096 bytes.
WS_SERVICE_ENDPOINT_PROPERTY_MESSAGE_PROPERTIES
Valor: 6
Essa propriedade permite que o usuário especifique as propriedades da mensagem
objetos usados pelo ponto de extremidade para enviar e receber mensagens.


Essa propriedade pode ser especificada quando o host de serviço é criado.


O valor especificado deve ser do tipo WS_MESSAGE_PROPERTIES.


As seguintes propriedades de mensagem podem ser especificadas:
WS_SERVICE_ENDPOINT_PROPERTY_MAX_CALL_POOL_SIZE
Valor: 7
O número máximo de objetos de serviço de chamada que seriam agrupados para atender a um objeto de mensagem, em um determinado
Extremidade. Observe que, no caso de canais baseados em sessão, muitos objetos de chamada podem ser usados em um único
se WS_SERVICE_ENDPOINT_PROPERTY_MAX_CONCURRENCY for maior que 1.


Para canais sem sessão, essa propriedade deve ser idealmente igual a WS_SERVICE_ENDPOINT_PROPERTY_MAX_CHANNEL_POOL_SIZE.


O padrão é 100.
WS_SERVICE_ENDPOINT_PROPERTY_MAX_CHANNEL_POOL_SIZE
Valor: 8
O número máximo de WS_CHANNEL que serão agrupados pelo Host de Serviço em um determinado
Extremidade.


O padrão é 100.
WS_SERVICE_ENDPOINT_PROPERTY_LISTENER_PROPERTIES
Valor: 9
Propriedades do ouvinte.
WS_SERVICE_ENDPOINT_PROPERTY_CHECK_MUST_UNDERSTAND
Valor: 10
Habilitar ou desabilitar deve entender a verificação de cabeçalho em um ponto de extremidade. Isso é 'TRUE' por padrão.
WS_SERVICE_ENDPOINT_PROPERTY_METADATA_EXCHANGE_TYPE
Valor: 11
Essa propriedade pode ser definida como WS_METADATA_EXCHANGE_TYPE_MEX para habilitar
manutenção de solicitações de WS-MetadataExchange no ponto de extremidade. Caso o aplicativo deseje
expor metadados por meio de HTTP GET, essa propriedade pode ser definida como WS_METADATA_EXCHANGE_TYPE_HTTP_GET

Se não for especificado, o valor padrão dessa propriedade será 'WS_METADATA_EXCHANGE_TYPE_NONE'.


Observe que essa propriedade quando definida como WS_METADATA_EXCHANGE_TYPE_HTTP_GET altera a propriedade WS_LISTENER
WS_LISTENER_PROPERTY_TRANSPORT_URL_MATCHING_OPTIONS e
WS_LISTENER_PROPERTY_TO_HEADER_MATCHING_OPTIONSWS_MATCH_URL_PREFIX_PATH.


Ao definir essa propriedade como WS_METADATA_EXCHANGE_TYPE_HTTP_GET um aplicativo não deve especificar WS_MATCH_URL_EXACT_PATH para o ouvinte
WS_LISTENER_PROPERTY_TRANSPORT_URL_MATCHING_OPTIONS e WS_LISTENER_PROPERTY_TO_HEADER_MATCHING_OPTIONS para o WS_SERVICE_ENDPOINT determinado.
WS_SERVICE_ENDPOINT_PROPERTY_METADATA
Valor: 12
Especifica o nome da porta WSDL, o nome da associação e o namespace de associação para o ponto de extremidade.


Essa propriedade deve ser especificada para habilitar a participação do WS_SERVICE_ENDPOINT no WS-Metadata Exchange.


Consulte WS_SERVICE_ENDPOINT_METADATA para obter mais detalhes.
WS_SERVICE_ENDPOINT_PROPERTY_METADATA_EXCHANGE_URL_SUFFIX
Valor: 13
Especifica o sufixo concatenado como está na URL do WS_SERVICE_ENDPOINT para gerar uma URL para WS-MetadataExchange serviço de solicitações v1.1.
A URL gerada é usada para comparar com o cabeçalho 'to' da mensagem recebida. Observe que, se a mensagem não contiver um cabeçalho 'to', as solicitações não serão
Serviced.


Essa propriedade só deverá ser especificada se WS_SERVICE_ENDPOINT_PROPERTY_METADATA_EXCHANGE_TYPE estiver definido como WS_METADATA_EXCHANGE_TYPE_MEX.


Especificar essa propriedade é útil nos casos em que um aplicativo deseja lidar com WS-Transfer Obter solicitações, bem como usar o mesmo ponto de extremidade para serviço
WS-MetadataExchange solicitações v1.1. Nesse caso, a URL de geração é usada para filtrar WS-Transfer Obter solicitações para Ws-MetadataExchange v1.1.


Por padrão, nenhuma filtragem é feita para WS-MetadataExchange v1.1 para MEX e todas as solicitações GET WS-Transfer serão tratadas pelo ponto de extremidade para Ws-MetadataExchange v1.1, se
Ws-MetadataExchange v1.1 está habilitado no ponto de extremidade.


Observe que essa propriedade altera a propriedade WS_LISTENERWS_LISTENER_PROPERTY_TRANSPORT_URL_MATCHING_OPTIONS e
WS_LISTENER_PROPERTY_TO_HEADER_MATCHING_OPTIONSWS_MATCH_URL_PREFIX_PATH.


Ao definir essa propriedade, um aplicativo não deve especificar WS_MATCH_URL_EXACT_PATH para o ouvinte
propriedades WS_LISTENER_PROPERTY_TRANSPORT_URL_MATCHING_OPTIONS e WS_LISTENER_PROPERTY_TO_HEADER_MATCHING_OPTIONS
para o WS_SERVICE_ENDPOINT determinado.
WS_SERVICE_ENDPOINT_PROPERTY_MAX_CHANNELS
Valor: 14
O número máximo de canais que podem ser atendidos no ponto de extremidade.


O valor padrão é 100.

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]
Cabeçalho webservices.h