Share via

WS_SERVICE_ENDPOINT_PROPERTY_ID 枚举 (webservices.h)

  • 项目

每个属性表示用于配置给定 WS_SERVICE_ENDPOINT 结构的可选参数。 此枚举在属于WS_SERVICE_ENDPOINT的WS_SERVICE_ENDPOINT_PROPERTY结构中使用。

语法

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_MATCH_URL_PREFIX_PATHWS_LISTENER_PROPERTY_TO_HEADER_MATCHING_OPTIONS。


将此属性设置为WS_METADATA_EXCHANGE_TYPE_HTTP_GET应用程序不得为侦听器指定WS_MATCH_URL_EXACT_PATH
属性 WS_LISTENER_PROPERTY_TRANSPORT_URL_MATCHING_OPTIONS 给定 WS_SERVICE_ENDPOINT 和 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 Get 请求以及使用相同的终结点提供服务，则指定此属性非常有用
WS-MetadataExchange v1.1 请求。 在这种情况下，生成 URL 用于筛选出 WS-Transfer 获取 Ws-MetadataExchange v1.1 的请求。


默认情况下，对于 MEX 的 WS-MetadataExchange v1.1 不执行筛选，所有 WS-Transfer GET 请求都将由 Ws-MetadataExchange v1.1 的终结点处理，如果
Ws-MetadataExchange 终结点上启用了 v1.1。


请注意，此属性更改 WS_LISTENER 属性 WS_LISTENER_PROPERTY_TRANSPORT_URL_MATCHING_OPTIONS 和
要WS_MATCH_URL_PREFIX_PATHWS_LISTENER_PROPERTY_TO_HEADER_MATCHING_OPTIONS。


设置此属性时，应用程序不得为侦听器指定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