Share via

WS_PROXY_PROPERTY_ID webservices.h () 列舉

  • 發行項

設定服務 Proxy 的選擇性參數。 除了 WS_PROXY_PROPERTY_STATE 所有值都僅支援與 WsCreateServiceProxy 搭配使用，作為 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;

常數

 
WS_PROXY_PROPERTY_CALL_TIMEOUT
值： 0
呼叫維持擱置的時間量上限，以毫秒為單位。
預設值為 30000 毫秒， (30 秒) 。 其類型為 ULONG。

如果應用程式想要沒有與呼叫相關聯的逾時，它可以將值設定為 INFINITE。


此屬性僅寫入。
WS_PROXY_PROPERTY_MESSAGE_PROPERTIES
值： 1
此屬性可讓使用者指定訊息的屬性
服務 Proxy 用來傳送和接收訊息的物件。


建立服務 Proxy 時，可以指定這個屬性。


指定的值應該是類型 WS_MESSAGE_PROPERTIES。


可以指定下列訊息屬性：
WS_PROXY_PROPERTY_MAX_CALL_POOL_SIZE
值： 2
服務 Proxy 中的每個呼叫都是由服務 Proxy 內部的物件表示。
呼叫物件是設計成在每次呼叫之後，都可以重複使用它。
這可讓應用程式在預期的情況中調整得更好
透過服務 Proxy 進行大量呼叫。 此屬性的預設值為 5。
其類型為 USHORT。

此屬性僅寫入。
WS_PROXY_PROPERTY_STATE
值： 3
服務 Proxy 的目前狀態。
其類型為 WS_SERVICE_PROXY_STATE。

這是一個唯讀的屬性。


傳回的值是目前狀態的快照集，因此它是
在呼叫端擁有之前，狀態可能已經變更
有機會檢查值。
WS_PROXY_PROPERTY_MAX_PENDING_CALLS
值： 4
服務 Proxy 上允許的擱置呼叫數目上限。 如果裝置上無法使用
服務 Proxy 上擱置的呼叫數目上限達到此限制，
WS_E_QUOTA_EXCEEDED (將拒絕來電，請參閱Windows Web 服務傳回值) 。 預設值
此屬性的 值為 100。
其類型為 ULONG。

此屬性僅寫入。
WS_PROXY_PROPERTY_MAX_CLOSE_TIMEOUT
值： 5
服務 Proxy 等候擱置呼叫完成的時間量，以毫秒為單位。
逾時到期後，服務 Proxy 將自行中止。


此屬性的預設值為 5000 (5 秒) 。


此屬性僅寫入。
其類型為 ULONG。
WS_PROXY_FAULT_LANG_ID
值： 6
用於傳回錯誤的 LANGID。 如果未指定預設使用者地區設定，則會使用 。 其類型為 LANGID。


此屬性僅寫入。

規格需求

   
最低支援的用戶端 Windows 7 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2008 R2 [傳統型應用程式 |UWP 應用程式]
標頭 webservices.h