通过

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_MAX_CHANNELS_PER_IP
} 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-Transfer GET 请求都将由 Ws-MetadataExchange v1.1 的终结点处理（如果）
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