enumeración WS_PROXY_PROPERTY_ID (webservices.h)

  • Artículo

Parámetros opcionales para configurar el proxy de servicio. Con una excepción de WS_PROXY_PROPERTY_STATE todos los valores solo se admiten para su uso con WsCreateServiceProxy como parte del 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
Cantidad máxima de tiempo en milisegundos para que una llamada permanezca pendiente.
El valor predeterminado es 30000 milisegundos(30 segundos). Es de tipo ULONG.

Si una aplicación desea no tener ningún tiempo de espera asociado a una llamada, puede establecer el valor en INFINITE.


Esta propiedad es de solo escritura.
WS_PROXY_PROPERTY_MESSAGE_PROPERTIES
Valor: 1
Esta propiedad permite al usuario especificar las propiedades del mensaje.
objetos usados por el proxy de servicio para enviar y recibir mensajes.


Esta propiedad se puede especificar cuando se crea el proxy de servicio.


El valor especificado debe ser de tipo WS_MESSAGE_PROPERTIES.


Se pueden especificar las siguientes propiedades de mensaje:
WS_PROXY_PROPERTY_MAX_CALL_POOL_SIZE
Valor: 2
Cada llamada en el proxy de servicio se representa mediante un objeto interno en el proxy de servicio.
Un objeto de llamada está diseñado de forma que después de cada llamada se pueda reutilizar.
Esto permite que las aplicaciones se escalen mejor en escenarios en los que esperan
gran número de llamadas a través del proxy de servicio. El valor predeterminado de esta propiedad es 5.
Es de tipo USHORT.

Esta propiedad es de solo escritura.
WS_PROXY_PROPERTY_STATE
Valor: 3
Estado actual del proxy de servicio.
Es de tipo WS_SERVICE_PROXY_STATE.

Esta propiedad es de solo lectura.


El valor devuelto es una instantánea del estado actual, por lo que es
posible que el estado haya cambiado antes de que el autor de la llamada tenga
tuvo la oportunidad de examinar el valor.
WS_PROXY_PROPERTY_MAX_PENDING_CALLS
Valor: 4
Número máximo de llamadas pendientes permitidas en el proxy de servicio. Si el parámetro
el número máximo de llamadas pendientes en el proxy de servicio alcanza este límite, el
Las llamadas entrantes se rechazarán con WS_E_QUOTA_EXCEEDED (consulte Valores devueltos de servicios web de Windows). el valor predeterminado
para esta propiedad es 100.
Es de tipo ULONG.

Esta propiedad es de solo escritura.
WS_PROXY_PROPERTY_MAX_CLOSE_TIMEOUT
Valor: 5
La cantidad de tiempo en milisegundos que el proxy de servicio esperará a que se completen las llamadas pendientes.
Una vez que expire el tiempo de espera, el proxy de servicio se anulará.


El valor predeterminado de esta propiedad es 5000 (5 segundos).


Esta propiedad es de solo escritura.
Es de tipo ULONG.
WS_PROXY_FAULT_LANG_ID
Valor: 6
LangID que se usaría para devolver un error. Si no se usará ninguna configuración regional de usuario predeterminada especificada. Es de tipo LANGID.


Esta propiedad es de solo escritura.

Requisitos

   
Cliente mínimo compatible Windows 7 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2008 R2 [aplicaciones de escritorio | Aplicaciones para UWP]
Encabezado webservices.h