WS_PROXY_PROPERTY_ID 枚举 (webservices.h)

用于配置服务代理的可选参数。 除了 WS_PROXY_PROPERTY_STATE 所有值仅支持与 WsCreateServiceProxy 一起使用,作为 WS_PROXY_PROPERTY* 参数的一部分。

语法

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;

常量

 
WS_PROXY_PROPERTY_CALL_TIMEOUT
值: 0
调用保持挂起状态的最长时间(以毫秒为单位)。
默认值为 30000 毫秒 (30 秒) 。 它的类型为 ULONG

如果应用程序希望没有与调用关联的超时,则可以将值设置为 INFINITE。


此属性为仅写入。
WS_PROXY_PROPERTY_MESSAGE_PROPERTIES
值:1
此属性允许用户指定消息的属性
服务代理用于发送和接收消息的 对象。


可以在创建服务代理时指定此属性。


指定的值应为 WS_MESSAGE_PROPERTIES 类型。


可以指定以下消息属性:


WS_PROXY_PROPERTY_MAX_CALL_POOL_SIZE
值: 2
服务代理中的每个调用都由服务代理的内部对象表示。
调用对象的设计使每次调用后都可以重复使用。
这样,应用程序就可以在预期场景中更好地缩放
通过服务代理进行大量调用。 此属性的默认值为 5。
它的类型为 USHORT

此属性为仅写入。
WS_PROXY_PROPERTY_STATE
值: 3
服务代理的当前状态。
它的类型 为 WS_SERVICE_PROXY_STATE

此属性为只读属性。


返回的值是当前状态的快照,因此为
状态可能已在调用方之前发生更改
有机会检查值。
WS_PROXY_PROPERTY_MAX_PENDING_CALLS
值: 4
服务代理上允许的最大挂起调用数。 如果你的设备不支持
服务代理上挂起的最大调用数达到此限制,
传入呼叫将被拒绝 ,WS_E_QUOTA_EXCEEDED (请参阅 Windows Web Services 返回值) 。 默认值
此属性为 100。
它的类型为 ULONG

此属性为仅写入。
WS_PROXY_PROPERTY_MAX_CLOSE_TIMEOUT
值: 5
服务代理等待挂起的调用完成的时间(以毫秒为单位)。
超时到期后,服务代理将自行中止。


此属性的默认值为 5000 (5 秒) 。


此属性为仅写入。
它的类型为 ULONG
WS_PROXY_FAULT_LANG_ID
值: 6
将用于返回错误的 LANGID。 如果未指定任何用户区域设置,则将使用默认用户区域设置。 它的类型为 LANGID


此属性为仅写入。

要求

   
最低受支持的客户端 Windows 7 [桌面应用 |UWP 应用]
最低受支持的服务器 Windows Server 2008 R2 [桌面应用 |UWP 应用]
标头 webservices.h