WS_SERVICE_ENDPOINT_PROPERTY_ID enumeration

Each property represents optional parameters for configuring the given WS_SERVICE_ENDPOINT structure. This enumeration is used within the WS_SERVICE_ENDPOINT_PROPERTY structure that is part of WS_SERVICE_ENDPOINT.

Syntax


enum WS_SERVICE_ENDPOINT_PROPERTY_ID {  WS_SERVICE_ENDPOINT_PROPERTY_ACCEPT_CHANNEL_CALLBACK, 
  WS_SERVICE_ENDPOINT_PROPERTY_CLOSE_CHANNEL_CALLBACK, 
  WS_SERVICE_ENDPOINT_PROPERTY_MAX_ACCEPTING_CHANNELS, 
  WS_SERVICE_ENDPOINT_PROPERTY_MAX_CONCURRENCY, 
  WS_SERVICE_ENDPOINT_PROPERTY_BODY_HEAP_MAX_SIZE, 
  WS_SERVICE_ENDPOINT_PROPERTY_BODY_HEAP_TRIM_SIZE, 
  WS_SERVICE_ENDPOINT_PROPERTY_MESSAGE_PROPERTIES, 
  WS_SERVICE_ENDPOINT_PROPERTY_MAX_CALL_POOL_SIZE, 
  WS_SERVICE_ENDPOINT_PROPERTY_MAX_CHANNEL_POOL_SIZE, 
  WS_SERVICE_ENDPOINT_PROPERTY_LISTENER_PROPERTIES, 
  WS_SERVICE_ENDPOINT_PROPERTY_CHECK_MUST_UNDERSTAND, 
  WS_SERVICE_ENDPOINT_PROPERTY_METADATA_EXCHANGE_TYPE, 
  WS_SERVICE_ENDPOINT_PROPERTY_METADATA, 
  WS_SERVICE_ENDPOINT_PROPERTY_METADATA_EXCHANGE_URL_SUFFIX, 
  WS_SERVICE_ENDPOINT_PROPERTY_MAX_CHANNELS 

};

Constants

WS_SERVICE_ENDPOINT_PROPERTY_ACCEPT_CHANNEL_CALLBACK

Used with WS_SERVICE_ENDPOINT. The value is a pointer to WS_SERVICE_PROPERTY_ACCEPT_CALLBACK structure.

WS_SERVICE_ENDPOINT_PROPERTY_CLOSE_CHANNEL_CALLBACK

Used with WS_SERVICE_ENDPOINT. The value is a pointer to WS_SERVICE_PROPERTY_CLOSE_CALLBACK structure.

WS_SERVICE_ENDPOINT_PROPERTY_MAX_ACCEPTING_CHANNELS

Used with WS_SERVICE_ENDPOINT, this specifies the maximum number of concurrent channels service host will have actively accepting new connections for a given endpoint. When not specified this value is set to 1. If an endpoint specifies a default message handler (See WS_SERVICE_ENDPOINT) concurrency has to be 1.

WS_SERVICE_ENDPOINT_PROPERTY_MAX_CONCURRENCY

Used with WS_SERVICE_ENDPOINT, this specifies the maximum number of concurrent calls that would be serviced on a session based channel. When not specified this value is set to 1. If an endpoint specifies a default message handler (See WS_SERVICE_ENDPOINT concurrency has to be 1.

WS_SERVICE_ENDPOINT_PROPERTY_BODY_HEAP_MAX_SIZE

Maximum heap size for body deserialization.

This is the heap available setting used for deserializing the body. This heap is also available to service operations for allocating out parameters.

Default is 65535 bytes.

WS_SERVICE_ENDPOINT_PROPERTY_BODY_HEAP_TRIM_SIZE

Heap trim size for body deserialization.

This is the heap available setting used for deserializing the body. This heap is also available to service operations for allocating out parameters.

Default is 4096 bytes.

WS_SERVICE_ENDPOINT_PROPERTY_MESSAGE_PROPERTIES

This property allows the user to specify properties of the message objects used by the endpoint to send and receive messages.

This property may be specified when the service host is created.

The value specified should be of type WS_MESSAGE_PROPERTIES.

The following message properties may be specified:

WS_SERVICE_ENDPOINT_PROPERTY_MAX_CALL_POOL_SIZE

The maximum number of call servicing objects that would be pooled to service a message object, on a given endpoint. Note that in case of session based channels many call objects can be used on a single channel if WS_SERVICE_ENDPOINT_PROPERTY_MAX_CONCURRENCY is greater than 1.

For sessionless channels this property should ideally be equal to WS_SERVICE_ENDPOINT_PROPERTY_MAX_CHANNEL_POOL_SIZE.

Default is 100.

WS_SERVICE_ENDPOINT_PROPERTY_MAX_CHANNEL_POOL_SIZE

The maximum number of WS_CHANNEL which will be pooled by Service Host on a given endpoint.

Default is 100.

WS_SERVICE_ENDPOINT_PROPERTY_LISTENER_PROPERTIES

Listener properties.

WS_SERVICE_ENDPOINT_PROPERTY_CHECK_MUST_UNDERSTAND

Enables or disables must understand header verification on an endpoint. This is 'TRUE' by default.

WS_SERVICE_ENDPOINT_PROPERTY_METADATA_EXCHANGE_TYPE

This property can be set to WS_METADATA_EXCHANGE_TYPE_MEX to enable servicing of WS-MetadataExchange requests on the endpoint. In case the application wishes to expose metadata through HTTP GET, this property can be set to WS_METADATA_EXCHANGE_TYPE_HTTP_GET

If not specified, the default value of this property is 'WS_METADATA_EXCHANGE_TYPE_NONE'.

Note that this property when set to WS_METADATA_EXCHANGE_TYPE_HTTP_GET changes the WS_LISTENER property WS_LISTENER_PROPERTY_TRANSPORT_URL_MATCHING_OPTIONS and WS_LISTENER_PROPERTY_TO_HEADER_MATCHING_OPTIONS to WS_MATCH_URL_PREFIX_PATH.

When setting this property to WS_METADATA_EXCHANGE_TYPE_HTTP_GET an application must not specify WS_MATCH_URL_EXACT_PATH for the listener properties WS_LISTENER_PROPERTY_TRANSPORT_URL_MATCHING_OPTIONS and WS_LISTENER_PROPERTY_TO_HEADER_MATCHING_OPTIONS for the given WS_SERVICE_ENDPOINT.

WS_SERVICE_ENDPOINT_PROPERTY_METADATA

Specifies the WSDL port name, binding name and binding namespace for the endpoint.

This property must be specified to enable the participation of the WS_SERVICE_ENDPOINT in WS-Metadata Exchange.

See WS_SERVICE_ENDPOINT_METADATA for more details.

WS_SERVICE_ENDPOINT_PROPERTY_METADATA_EXCHANGE_URL_SUFFIX

Specifies the suffix which is concatenated as is to the WS_SERVICE_ENDPOINT URL to generate a URL for WS-MetadataExchange v1.1 requests servicing. The generated URL is used to compare against the 'to' header of the message received. Note that if the message does not contain a 'to' header the requests is not serviced.

This property must only be specified if WS_SERVICE_ENDPOINT_PROPERTY_METADATA_EXCHANGE_TYPE is set to WS_METADATA_EXCHANGE_TYPE_MEX.

Specifying this property is useful in cases where an application wishes to handle WS-Transfer Get requests as well as use the same endpoint to service WS-MetadataExchange v1.1 requests. The generate URL in this case is used to filter out WS-Transfer Get requests for Ws-MetadataExchange v1.1.

By default no filtering is done for WS-MetadataExchange v1.1 for MEX and all WS-Transfer GET requests will be handled by the endpoint for Ws-MetadataExchange v1.1, if Ws-MetadataExchange v1.1 is enabled on the endpoint.

Note that this property changes the WS_LISTENER property WS_LISTENER_PROPERTY_TRANSPORT_URL_MATCHING_OPTIONS and WS_LISTENER_PROPERTY_TO_HEADER_MATCHING_OPTIONS to WS_MATCH_URL_PREFIX_PATH.

When setting this property an application must not specify WS_MATCH_URL_EXACT_PATH for the listener properties WS_LISTENER_PROPERTY_TRANSPORT_URL_MATCHING_OPTIONS and WS_LISTENER_PROPERTY_TO_HEADER_MATCHING_OPTIONS for the given WS_SERVICE_ENDPOINT.

WS_SERVICE_ENDPOINT_PROPERTY_MAX_CHANNELS

The maximum number of channels that can be serviced on the endpoint.

The default value is 100.

Requirements

Minimum supported client

Windows 7 [desktop apps only]

Minimum supported server

Windows Server 2008 R2 [desktop apps only]

Header

WebServices.h

 

 

Community Additions

ADD
Show: