Compartilhar via

enumeração WS_PROXY_PROPERTY_ID (webservices.h)

  • Artigo

Parâmetros opcionais para configurar o proxy de serviço. Com exceção de WS_PROXY_PROPERTY_STATE todos os valores só têm suporte para uso com WsCreateServiceProxy como parte do parâmetro WS_PROXY_PROPERTY* .

Syntax

typedef enum {
  WS_PROXY_PROPERTY_CALL_TIMEOUT = 0,
  WS_PROXY_PROPERTY_MESSAGE_PROPERTIES = 1,
  WS_PROXY_PROPERTY_MAX_CALL_POOL_SIZE = 2,
  WS_PROXY_PROPERTY_STATE = 3,
  WS_PROXY_PROPERTY_MAX_PENDING_CALLS = 4,
  WS_PROXY_PROPERTY_MAX_CLOSE_TIMEOUT = 5,
  WS_PROXY_FAULT_LANG_ID = 6
} WS_PROXY_PROPERTY_ID;

Constantes

 
WS_PROXY_PROPERTY_CALL_TIMEOUT
Valor: 0
A quantidade máxima de tempo em milissegundos para uma chamada permanecer pendente.
O padrão é 30000 milissegundos (30 segundos). É do tipo ULONG.

Se um aplicativo quiser não ter tempo limite associado a uma chamada, ele poderá definir o valor como INFINITE.


Essa propriedade é somente gravação.
WS_PROXY_PROPERTY_MESSAGE_PROPERTIES
Valor: 1
Essa propriedade permite que o usuário especifique as propriedades da mensagem
objetos usados pelo proxy de serviço para enviar e receber mensagens.


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


O valor especificado deve ser do tipo WS_MESSAGE_PROPERTIES.


As seguintes propriedades de mensagem podem ser especificadas:
WS_PROXY_PROPERTY_MAX_CALL_POOL_SIZE
Valor: 2
Cada chamada no proxy de serviço é representada por um objeto interno para o proxy de serviço.
Um objeto de chamada foi projetado de modo que, após cada chamada, ele possa ser reutilizado.
Isso permite que os aplicativos sejam dimensionados melhor em cenários em que eles esperam
grande número de chamadas pelo proxy de serviço. O valor padrão dessa propriedade é 5.
É do tipo USHORT.

Essa propriedade é somente gravação.
WS_PROXY_PROPERTY_STATE
Valor: 3
O estado atual do proxy de serviço.
É do tipo WS_SERVICE_PROXY_STATE.

Essa propriedade é somente leitura.


O valor retornado é um instantâneo do estado atual, portanto, é
possível que o estado pode ter sido alterado antes que o chamador tenha
teve a chance de examinar o valor.
WS_PROXY_PROPERTY_MAX_PENDING_CALLS
Valor: 4
O número máximo de chamadas pendentes permitidas no proxy de serviço. Se a opção
número máximo de chamadas pendentes no proxy de serviço atinge esse limite, o
As chamadas recebidas serão rejeitadas com WS_E_QUOTA_EXCEEDED (consulte Valores retornados dos Serviços Web do Windows). O valor padrão
para essa propriedade é 100.
É do tipo ULONG.

Essa propriedade é somente gravação.
WS_PROXY_PROPERTY_MAX_CLOSE_TIMEOUT
Valor: 5
A quantidade de tempo em milissegundos que o proxy de serviço aguardará a conclusão das chamadas pendentes.
Depois que o tempo limite expirar, o proxy de serviço será anulado.


O valor padrão dessa propriedade é 5000 (5 segundos).


Essa propriedade é somente gravação.
É do tipo ULONG.
WS_PROXY_FAULT_LANG_ID
Valor: 6
O LANGID que seria usado para retornar uma falha. Se nenhuma localidade de usuário padrão especificada for usada. É do tipo LANGID.


Essa propriedade é somente gravação.

Requisitos

   
Cliente mínimo com suporte Windows 7 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2008 R2 [aplicativos da área de trabalho | Aplicativos UWP]
Cabeçalho webservices.h