Поделиться через

перечисление WS_SERVICE_ENDPOINT_PROPERTY_ID (webservices.h)

  • Статья

Каждое свойство представляет необязательные параметры для настройки заданной структуры WS_SERVICE_ENDPOINT . Это перечисление используется в структуре WS_SERVICE_ENDPOINT_PROPERTY , которая является частью WS_SERVICE_ENDPOINT.

Синтаксис

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_LISTENER_PROPERTY_TRANSPORT_URL_MATCHING_OPTIONS и WS_LISTENER_PROPERTY_TO_HEADER_MATCHING_OPTIONS для заданного WS_SERVICE_ENDPOINT.
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
Указывает суффикс, который объединяется как есть с URL-адресом WS_SERVICE_ENDPOINT для создания URL-адреса для WS-MetadataExchange обслуживания запросов версии 1.1.
Созданный URL-адрес используется для сравнения с заголовком "to" полученного сообщения. Обратите внимание, что если сообщение не содержит заголовок "to", запросы не будут
Обслуживанием.


Это свойство необходимо указывать только в том случае, если WS_SERVICE_ENDPOINT_PROPERTY_METADATA_EXCHANGE_TYPE имеет значение WS_METADATA_EXCHANGE_TYPE_MEX.


Указание этого свойства полезно в тех случаях, когда приложение хочет обрабатывать запросы WS-Transfer Get, а также использовать ту же конечную точку для обслуживания.
WS-MetadataExchange запросов версии 1.1. В этом случае url-адрес создания используется для фильтрации WS-Transfer Получения запросов для Ws-MetadataExchange версии 1.1.


По умолчанию фильтрация для WS-MetadataExchange версии 1.1 для MEX не выполняется, и все запросы GET WS-Transfer будут обрабатываться конечной точкой для Ws-MetadataExchange версии 1.1, если
Ws-MetadataExchange версия 1.1 включена в конечной точке.


Обратите внимание, что это свойство изменяет свойство WS_LISTENERWS_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