共用方式為

WS_SERVICE_ENDPOINT_PROPERTY_ID列舉 (webservices.h)

  • 發行項

每個屬性都代表用來設定指定 WS_SERVICE_ENDPOINT 結構的選擇性參數。 這個列舉用於屬於WS_SERVICE_ENDPOINT的WS_SERVICE_ENDPOINT_PROPERTY結構內。

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;

常數

 
WS_SERVICE_ENDPOINT_PROPERTY_ACCEPT_CHANNEL_CALLBACK
值： 0
與 WS_SERVICE_ENDPOINT 搭配使用。
值是WS_SERVICE_PROPERTY_ACCEPT_CALLBACK結構的指標。
WS_SERVICE_ENDPOINT_PROPERTY_CLOSE_CHANNEL_CALLBACK
值： 1
與 WS_SERVICE_ENDPOINT 搭配使用。
值是WS_SERVICE_PROPERTY_CLOSE_CALLBACK結構的指標。
WS_SERVICE_ENDPOINT_PROPERTY_MAX_ACCEPTING_CHANNELS
值： 2
與 WS_SERVICE_ENDPOINT搭配使用，這會指定並行通道服務主機將擁有的最大數目
主動接受指定端點的新連線。 未指定此值時，此值會設定為 1。 如果端點指定預設訊息處理程式 (請參閱 WS_SERVICE_ENDPOINT) 並行
必須是 1。
WS_SERVICE_ENDPOINT_PROPERTY_MAX_CONCURRENCY
值： 3
與 WS_SERVICE_ENDPOINT搭配使用，這會指定會話通道上服務的最大並行呼叫數目。
未指定此值時，此值會設定為 1。 如果端點指定預設訊息處理程式 (請參閱並行WS_SERVICE_ENDPOINT
必須是 1。
WS_SERVICE_ENDPOINT_PROPERTY_BODY_HEAP_MAX_SIZE
值： 4
本文還原串行化的最大 堆積 大小。


這是用於還原串行化本文的堆積可用設定。 此堆積也是
可用於配置參數的服務作業。


預設值為65535個字節。
WS_SERVICE_ENDPOINT_PROPERTY_BODY_HEAP_TRIM_SIZE
值： 5
本文 還原串行化的堆積修剪大小。


這是用於還原串行化本文的堆積可用設定。 此堆積也是
可用於配置參數的服務作業。


預設值為 4096 個字節。
WS_SERVICE_ENDPOINT_PROPERTY_MESSAGE_PROPERTIES
值： 6
此屬性可讓使用者指定訊息的屬性
端點用來傳送和接收訊息的物件。


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


指定的值應該是類型 WS_MESSAGE_PROPERTIES。


可以指定下列訊息屬性：
WS_SERVICE_ENDPOINT_PROPERTY_MAX_CALL_POOL_SIZE
值： 7
在給定的訊息物件上，將共用至服務訊息物件的呼叫服務物件數目上限
端點。 請注意，在會話型通道的情況下，許多呼叫物件都可以在單一上使用
如果WS_SERVICE_ENDPOINT_PROPERTY_MAX_CONCURRENCY大於 1 ， 則通道。


對於無會話通道，這個屬性在理想情況下應該等於 WS_SERVICE_ENDPOINT_PROPERTY_MAX_CHANNEL_POOL_SIZE。


預設值為 100。
WS_SERVICE_ENDPOINT_PROPERTY_MAX_CHANNEL_POOL_SIZE
值： 8
指定上服務主機將集區的最大 WS_CHANNEL 數目
端點。


預設值為 100。
WS_SERVICE_ENDPOINT_PROPERTY_LISTENER_PROPERTIES
值： 9
接聽程序屬性。
WS_SERVICE_ENDPOINT_PROPERTY_CHECK_MUST_UNDERSTAND
值： 10
啟用或停用必須瞭解端點上的標頭驗證。 根據預設，這是 『TRUE』。
WS_SERVICE_ENDPOINT_PROPERTY_METADATA_EXCHANGE_TYPE
值： 11
此屬性可以設定為 WS_METADATA_EXCHANGE_TYPE_MEX 以啟用
在端點上維護 WS-MetadataExchange 要求。 如果應用程式想要
透過 HTTP GET 公開元數據，此屬性可以設定為 WS_METADATA_EXCHANGE_TYPE_HTTP_GET

如果未指定，則此屬性的預設值為 『WS_METADATA_EXCHANGE_TYPE_NONE』。


請注意，當設定為 WS_METADATA_EXCHANGE_TYPE_HTTP_GET 變更 WS_LISTENER 屬性時，此屬性會變更
WS_LISTENER_PROPERTY_TRANSPORT_URL_MATCHING_OPTIONS 和
WS_LISTENER_PROPERTY_TO_HEADER_MATCHING_OPTIONSWS_MATCH_URL_PREFIX_PATH。


將此屬性設定為WS_METADATA_EXCHANGE_TYPE_HTTP_GET應用程式不得指定接聽程式的WS_MATCH_URL_EXACT_PATH
指定WS_SERVICE_ENDPOINT的屬性WS_LISTENER_PROPERTY_TRANSPORT_URL_MATCHING_OPTIONS和WS_LISTENER_PROPERTY_TO_HEADER_MATCHING_OPTIONS。
WS_SERVICE_ENDPOINT_PROPERTY_METADATA
值： 12
指定 端點的 WSDL 連接埠名稱、系結名稱和系結命名空間。


必須指定這個屬性，才能讓 WS_SERVICE_ENDPOINT參與 WS-Metadata Exchange。


如需詳細資訊 ，請參閱WS_SERVICE_ENDPOINT_METADATA 。
WS_SERVICE_ENDPOINT_PROPERTY_METADATA_EXCHANGE_URL_SUFFIX
值： 13
指定串連為 WS_SERVICE_ENDPOINT URL 的後綴，以產生服務 WS-MetadataExchange v1.1 要求的 URL。
產生的 URL 是用來與所接收訊息的 『to』 標頭進行比較。 請注意，如果訊息不包含 『to』 標頭，則要求不是
服務。


只有當 WS_SERVICE_ENDPOINT_PROPERTY_METADATA_EXCHANGE_TYPE 設定為 WS_METADATA_EXCHANGE_TYPE_MEX 時，才必須指定這個屬性。


如果應用程式想要處理 WS-Transfer 取得要求，以及使用相同的端點來服務，則指定此屬性很有用
WS-MetadataExchange v1.1 要求。 在此情況下，會產生 URL 可用來篩選出 WS-Transfer 取得 Ws-MetadataExchange v1.1 的要求。


根據預設，MEX 不會針對 WS-MetadataExchange v1.1 進行篩選，而且如果 Ws-MetadataExchange v1.1 的端點會處理所有 WS-Transfer GET 要求，
Ws-MetadataExchange 在端點上啟用 v1.1。


請注意，此屬性會變更 WS_LISTENER 屬性 WS_LISTENER_PROPERTY_TRANSPORT_URL_MATCHING_OPTIONS 和
WS_LISTENER_PROPERTY_TO_HEADER_MATCHING_OPTIONSWS_MATCH_URL_PREFIX_PATH。


設定此屬性時，應用程式不得指定接聽程式的WS_MATCH_URL_EXACT_PATH
屬性 WS_LISTENER_PROPERTY_TRANSPORT_URL_MATCHING_OPTIONS 和 WS_LISTENER_PROPERTY_TO_HEADER_MATCHING_OPTIONS
指定 WS_SERVICE_ENDPOINT。
WS_SERVICE_ENDPOINT_PROPERTY_MAX_CHANNELS
值： 14
可在端點上服務的通道數目上限。


預設值是 100。

規格需求

需求 值
最低支援的用戶端 Windows 7 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 R2 [僅限桌面應用程式]
標頭 webservices.h