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

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

  • Статья

Каждое свойство канала определяется идентификатором и имеет связанное значение. Если свойство не указано при создании канала, используется его значение по умолчанию.

Синтаксис

typedef enum {
  WS_CHANNEL_PROPERTY_MAX_BUFFERED_MESSAGE_SIZE = 0,
  WS_CHANNEL_PROPERTY_MAX_STREAMED_MESSAGE_SIZE = 1,
  WS_CHANNEL_PROPERTY_MAX_STREAMED_START_SIZE = 2,
  WS_CHANNEL_PROPERTY_MAX_STREAMED_FLUSH_SIZE = 3,
  WS_CHANNEL_PROPERTY_ENCODING = 4,
  WS_CHANNEL_PROPERTY_ENVELOPE_VERSION = 5,
  WS_CHANNEL_PROPERTY_ADDRESSING_VERSION = 6,
  WS_CHANNEL_PROPERTY_MAX_SESSION_DICTIONARY_SIZE = 7,
  WS_CHANNEL_PROPERTY_STATE = 8,
  WS_CHANNEL_PROPERTY_ASYNC_CALLBACK_MODEL = 9,
  WS_CHANNEL_PROPERTY_IP_VERSION = 10,
  WS_CHANNEL_PROPERTY_RESOLVE_TIMEOUT = 11,
  WS_CHANNEL_PROPERTY_CONNECT_TIMEOUT = 12,
  WS_CHANNEL_PROPERTY_SEND_TIMEOUT = 13,
  WS_CHANNEL_PROPERTY_RECEIVE_RESPONSE_TIMEOUT = 14,
  WS_CHANNEL_PROPERTY_RECEIVE_TIMEOUT = 15,
  WS_CHANNEL_PROPERTY_CLOSE_TIMEOUT = 16,
  WS_CHANNEL_PROPERTY_ENABLE_TIMEOUTS = 17,
  WS_CHANNEL_PROPERTY_TRANSFER_MODE = 18,
  WS_CHANNEL_PROPERTY_MULTICAST_INTERFACE = 19,
  WS_CHANNEL_PROPERTY_MULTICAST_HOPS = 20,
  WS_CHANNEL_PROPERTY_REMOTE_ADDRESS = 21,
  WS_CHANNEL_PROPERTY_REMOTE_IP_ADDRESS = 22,
  WS_CHANNEL_PROPERTY_HTTP_CONNECTION_ID = 23,
  WS_CHANNEL_PROPERTY_CUSTOM_CHANNEL_CALLBACKS = 24,
  WS_CHANNEL_PROPERTY_CUSTOM_CHANNEL_PARAMETERS = 25,
  WS_CHANNEL_PROPERTY_CUSTOM_CHANNEL_INSTANCE = 26,
  WS_CHANNEL_PROPERTY_TRANSPORT_URL = 27,
  WS_CHANNEL_PROPERTY_NO_DELAY = 28,
  WS_CHANNEL_PROPERTY_SEND_KEEP_ALIVES = 29,
  WS_CHANNEL_PROPERTY_KEEP_ALIVE_TIME = 30,
  WS_CHANNEL_PROPERTY_KEEP_ALIVE_INTERVAL = 31,
  WS_CHANNEL_PROPERTY_MAX_HTTP_SERVER_CONNECTIONS = 32,
  WS_CHANNEL_PROPERTY_IS_SESSION_SHUT_DOWN = 33,
  WS_CHANNEL_PROPERTY_CHANNEL_TYPE = 34,
  WS_CHANNEL_PROPERTY_TRIM_BUFFERED_MESSAGE_SIZE = 35,
  WS_CHANNEL_PROPERTY_ENCODER = 36,
  WS_CHANNEL_PROPERTY_DECODER = 37,
  WS_CHANNEL_PROPERTY_PROTECTION_LEVEL = 38,
  WS_CHANNEL_PROPERTY_COOKIE_MODE = 39,
  WS_CHANNEL_PROPERTY_HTTP_PROXY_SETTING_MODE = 40,
  WS_CHANNEL_PROPERTY_CUSTOM_HTTP_PROXY = 41,
  WS_CHANNEL_PROPERTY_HTTP_MESSAGE_MAPPING = 42,
  WS_CHANNEL_PROPERTY_ENABLE_HTTP_REDIRECT = 43,
  WS_CHANNEL_PROPERTY_HTTP_REDIRECT_CALLBACK_CONTEXT = 44,
  WS_CHANNEL_PROPERTY_FAULTS_AS_ERRORS = 45,
  WS_CHANNEL_PROPERTY_ALLOW_UNSECURED_FAULTS = 46,
  WS_CHANNEL_PROPERTY_HTTP_SERVER_SPN = 47,
  WS_CHANNEL_PROPERTY_HTTP_PROXY_SPN = 48,
  WS_CHANNEL_PROPERTY_MAX_HTTP_REQUEST_HEADERS_BUFFER_SIZE = 49
} WS_CHANNEL_PROPERTY_ID;

Константы

 
WS_CHANNEL_PROPERTY_MAX_BUFFERED_MESSAGE_SIZE
Значение: 0
ULONG
используется с WsCreateChannel, WsCreateChannelForListener или
WsGetChannelProperty для WS_TCP_CHANNEL_BINDING,
WS_HTTP_CHANNEL_BINDING или WS_NAMEDPIPE_CHANNEL_BINDING. Это значение является ограничением на величину
сообщение может быть получено или отправлено каналом. Ограничение указывает максимальный размер
конверта в байтах, как показано в закодированном виде провода.
Минимальное значение: 1.


Это свойство ограничивает объем памяти
значение, выделяемое каналом для получения или отправки буферизованного сообщения.
При получении с буферизацией входных данных все сообщение считывается в
буфер, прежде чем приложение имеет доступ к нему. При отправке с буферизацией выходных данных
перед отправкой все сообщение накапливается в буфере.


Это свойство может быть указано только в том случае, если буферизация входных или выходных данных имеет значение
указано ( WS_STREAMED_INPUT_TRANSFER_MODE или
WS_STREAMED_OUTPUT_TRANSFER_MODE не задано).


Значение по умолчанию — 65536.


В WS_UDP_CHANNEL_BINDING всегда используется значение 65536.
WS_CHANNEL_PROPERTY_MAX_STREAMED_MESSAGE_SIZE
Значение: 1
Неподписанный __int64 используется с WsCreateChannel, WsCreateChannelForListener или
WsGetChannelProperty
WS_HTTP_CHANNEL_BINDING. This
значение — это ограничение на то, как большой объем потокового сообщения может быть получен или отправлен
для канала.
Ограничение указывает максимальный размер конверта в байтах, как он отображается
в закодированной форме провода. Минимальное значение: 1.


Это свойство можно указать, только если выбран потоковый вход или выход.
(WS_STREAMED_INPUT_TRANSFER_MODE или WS_STREAMED_OUTPUT_TRANSFER_MODE задано).


Значение по умолчанию — 4194304.
WS_CHANNEL_PROPERTY_MAX_STREAMED_START_SIZE
Значение: 2
ULONG, используемый с WsCreateChannel, WsCreateChannelForListener или
WsGetChannelProperty для WS_HTTP_CHANNEL_BINDING.
Это значение является ограничением на то, насколько большим может быть начало сообщения.
Начало сообщения состоит из тега конверта, заголовков и тега body.
Ограничение указывает максимальный размер данных в байтах, как они отображаются в
его закодированная форма провода. Минимальное значение: 1.


Это свойство можно указать, только если выбран потоковый вход
(WS_STREAMED_INPUT_TRANSFER_MODE).


Это свойство ограничивает объем памяти, выделяемой каналом.
для чтения начала сообщения. Для потоковых входных данных —
Все начало сообщения будет считано в буфер перед приложением
получает уведомление о том, что начало сообщения было прочитано.


Значение по умолчанию — 16384.
WS_CHANNEL_PROPERTY_MAX_STREAMED_FLUSH_SIZE
Значение: 3
ULONG, используемый с WsCreateChannel, WsCreateChannelForListener или
WsGetChannelProperty для WS_HTTP_CHANNEL_BINDING.
Это значение является ограничением на количество байтов, которые будут накапливаться.
до вызова WsFlushBody .


Это свойство может быть указано только при выборе потокового вывода.
(WS_STREAMED_OUTPUT_TRANSFER_MODE).


Это свойство ограничивает объем памяти, выделяемой каналом.
для накопления буферизированных данных. Для выходных данных потоковой передачи
канал будет накапливать данные в буфере до вызова WsFlushBody .


Значение по умолчанию — 65536.
WS_CHANNEL_PROPERTY_ENCODING
Значение: 4
Значение WS_ENCODING
используется с WsCreateChannel, WsCreateChannelForListener или WsGetChannelProperty для WS_TCP_CHANNEL_BINDING или WS_HTTP_CHANNEL_BINDING.
Это значение указывает, какая кодировка будет использоваться для канала.


Значение по умолчанию зависит от привязки:



В WS_UDP_CHANNEL_BINDING всегда используется значение WS_ENCODING_XML_UTF8.
WS_CHANNEL_PROPERTY_ENVELOPE_VERSION
Значение: 5
Значение WS_ENVELOPE_VERSION
используется с WsCreateChannel, WsCreateChannelForListener или WsGetChannelProperty.
Это значение указывает, какая версия конверта будет использоваться для канала. The
версия конверта канала должна соответствовать версии сообщения, используемой с
канал.


Это свойство не поддерживается в WS_NAMEDPIPE_CHANNEL_BINDING. Каналы именованных каналов всегда используют WS_ENVELOPE_VERSION_SOAP_1_2.

Значение по умолчанию зависит от привязки:
WS_CHANNEL_PROPERTY_ADDRESSING_VERSION
Значение: 6
Значение WS_ADDRESSING_VERSION
используется с WsCreateChannel, WsCreateChannelForListener или WsGetChannelProperty.
Это значение указывает, какая версия адресации будет использоваться для канала. The
адресация версии канала должна соответствовать версии сообщения, используемого с
канал.


Значение по умолчанию зависит от привязки:



WS_ADDRESSING_VERSION_TRANSPORT поддерживается только для
WS_HTTP_CHANNEL_BINDING.
WS_CHANNEL_PROPERTY_MAX_SESSION_DICTIONARY_SIZE
Значение: 7
Объект ULONG, используемый с WsCreateChannel, WsCreateChannelForListener или WsGetChannelProperty.
Это свойство допустимо только для WS_TCP_CHANNEL_BINDING или WS_NAMEDPIPE_CHANNEL_BINDING.
Это значение указывает квоту на количество байтов словаря сеансов.
строки, которые будут передаваться или получаться при использовании кодировки на основе сеанса.


В настоящее время поддерживается только кодирование на основе сеанса.
WS_ENCODING_XML_BINARY_SESSION_1, которая является кодировкой по умолчанию
для WS_TCP_CHANNEL_BINDING.


Если квота достигнута на принимающей стороне, то канал
будет ошибкой.


Если квота достигнута на стороне отправки, канал будет просто
передать строку без использования словаря сеанса.


Это значение игнорируется, если не используется кодировка на основе сеанса.


Значение по умолчанию — 2048.
WS_CHANNEL_PROPERTY_STATE
Значение: 8
Значение WS_CHANNEL_STATE
возвращается WsGetChannelProperty.


Возвращаемое значение является snapshot текущего состояния, поэтому оно является
возможно, что состояние изменилось до того, как вызывающий объект
имел возможность изучить значение.
WS_CHANNEL_PROPERTY_ASYNC_CALLBACK_MODEL
Значение: 9
Значение WS_CALLBACK_MODEL , используемое с WsCreateChannel или WsGetChannelProperty.
Это значение указывает предпочтительную модель асинхронного обратного вызова при выдаче.
асинхронные операции для канала.


Если используется WsCreateChannelForListener, см. раздел
WS_LISTENER_PROPERTY_ASYNC_CALLBACK_MODEL.


Значение по умолчанию — WS_LONG_CALLBACK.


И WS_SERVICE_HOST , и WS_SERVICE_PROXY поддерживают только WS_LONG_CALLBACK
в качестве допустимого значения для этого свойства.
WS_CHANNEL_PROPERTY_IP_VERSION
Значение: 10
Значение WS_IP_VERSION
используется с WsCreateChannel или WsGetChannelProperty для WS_TCP_CHANNEL_BINDING или WS_UDP_CHANNEL_BINDING.
Это свойство указывает, для какой версии IP-адреса следует использовать канал.
обмен данными с удаленной конечной точкой.


Чтобы указать ip-версию для принимаемых каналов, используйте
WS_LISTENER_PROPERTY_IP_VERSION свойство прослушивателя при
создание объекта прослушивателя.


Значение по умолчанию — WS_IP_VERSION_AUTO.
WS_CHANNEL_PROPERTY_RESOLVE_TIMEOUT
Значение: 11
ULONG, используемый с WsCreateChannel, WsSetChannelProperty,
или WsSetChannelProperty для WS_HTTP_CHANNEL_BINDING и WS_CHANNEL_TYPE_REQUEST.
Это время ожидания ограничивает количество времени, которое будет потрачено на разрешение
DNS-имя. Значение времени ожидания — в миллисекундах.
где значение INFINITE указывает на отсутствие времени ожидания.


Это свойство можно задать в любом состоянии канала.


Значение по умолчанию — INFINITE.
WS_CHANNEL_PROPERTY_CONNECT_TIMEOUT
Значение: 12
ULONG, используемый с WsCreateChannel,
WsSetChannelProperty или WsGetChannelProperty
для WS_TCP_CHANNEL_BINDING или WS_NAMEDPIPE_CHANNEL_BINDING на стороне клиента.
Это время ожидания ограничивает количество времени, которое будет потрачено на подключение к удаленному компьютеру и завершение подтверждения net.tcp или net.pipe. Значение времени ожидания
имеет значение в миллисекундах, где значение INFINITE указывает на отсутствие времени ожидания. Чтобы задать
или получить соответствующее время ожидания на стороне сервера, используйте
(WS_LISTENER_PROPERTY_CONNECT_TIMEOUT).


Используется с WsCreateChannel,
WsSetChannelProperty или WsGetChannelProperty для WS_HTTP_CHANNEL_BINDING и WS_CHANNEL_TYPE_REQUEST.
Это время ожидания ограничивает количество времени, которое будет потрачено на подключение
на HTTP-сервер. Значение времени ожидания — в миллисекундах.
где значение INFINITE указывает на отсутствие времени ожидания.


Это свойство можно задать в любом состоянии канала.


Значение по умолчанию — 30 000 (30 секунд).


По умолчанию WS_SERVICE_PROXY устанавливает для этого тайм-аута значение INFINITE.
WS_CHANNEL_PROPERTY_SEND_TIMEOUT
Значение: 13
ULONG, используемый с WsCreateChannel, WsCreateChannelForListener,
WsSetChannelProperty или WsGetChannelProperty
для WS_TCP_CHANNEL_BINDING или WS_NAMEDPIPE_CHANNEL_BINDING. Это время ожидания ограничивает
количество времени, которое будет потрачено на отправку байтов сообщения.
Значение времени ожидания — в миллисекундах, где значение INFINITE указывает на
время ожидания отсутствует.


Используется с WsCreateChannel, WsSetChannelProperty,
или WsGetChannelProperty для WS_HTTP_CHANNEL_BINDING
и WS_CHANNEL_TYPE_REQUEST.
Это время ожидания ограничивает количество времени, которое будет потрачено на отправку
Заголовки HTTP и байты сообщения. Значение времени ожидания — в миллисекундах, где
Значение INFINITE указывает на отсутствие времени ожидания.


Это свойство можно задать в любом состоянии канала.


Значение по умолчанию — 30 000 (30 секунд).


Как WS_SERVICE_HOST , так и WS_SERVICE_PROXY задать этот параметр
По умолчанию истекло время ожидания бесконечности.
WS_CHANNEL_PROPERTY_RECEIVE_RESPONSE_TIMEOUT
Значение: 14
ULONG, используемый с WsCreateChannel, WsSetChannelProperty,
или WsSetChannelProperty для WS_HTTP_CHANNEL_BINDING и WS_CHANNEL_TYPE_REQUEST.
Это время ожидания ограничивает количество времени, которое будет потрачено на ожидание
все заголовки ответов, которые будут получены с сервера.
Значение времени ожидания — в миллисекундах, где значение INFINITE указывает на отсутствие времени ожидания.


Это свойство можно задать в любом состоянии канала.


Значение по умолчанию — 30 000 (30 секунд).


WS_SERVICE_PROXY устанавливает для этого времени ожидания значение INFINITE.
WS_CHANNEL_PROPERTY_RECEIVE_TIMEOUT
Значение: 15
ULONG, используемый с WsCreateChannel, WsCreateChannelForListener,
WsSetChannelProperty или WsGetChannelProperty,
для WS_TCP_CHANNEL_BINDING или WS_NAMEDPIPE_CHANNEL_BINDING.
Это время ожидания ограничивает количество времени, которое будет потрачено на получение
байты сообщения.
Значение времени ожидания — в миллисекундах, где значение INFINITE указывает
время ожидания отсутствует.


Используется с WsCreateChannel, WsSetChannelProperty,
или WsGetChannelProperty для WS_HTTP_CHANNEL_BINDING и WS_CHANNEL_TYPE_REQUEST.
Это время ожидания ограничивает количество времени, которое будет потрачено на получение
байт сообщения. Значение времени ожидания — в миллисекундах.
где значение INFINITE указывает на отсутствие времени ожидания.
Это время ожидания может быть активировано WsWriteMessageEnd, WsReadMessageStart и WsReadMessageEnd.

Это свойство можно задать в любом состоянии канала.


Значение по умолчанию — 30 000 (30 секунд).


Как WS_SERVICE_HOST , так и WS_SERVICE_PROXY задать этот параметр
По умолчанию истекло время ожидания бесконечности.
WS_CHANNEL_PROPERTY_CLOSE_TIMEOUT
Значение: 16
ULONG, используемый с WsCreateChannel, WsCreateChannelForListener
WsSetChannelProperty или WsGetChannelProperty
для WS_TCP_CHANNEL_BINDING или WS_NAMEDPIPE_CHANNEL_BINDING.
Это время ожидания ограничивает количество времени, которое будет потрачено на выполнение
подтверждение закрытия net.tcp или net.pipe. Значение времени ожидания — в миллисекундах, где
Значение INFINITE указывает на отсутствие времени ожидания.


Это свойство можно задать в любом состоянии канала.


Значение по умолчанию — 30 000 (30 секунд).


По умолчанию WS_SERVICE_PROXY устанавливает для этого времени ожидания значение INFINITE.
WS_CHANNEL_PROPERTY_ENABLE_TIMEOUTS
Значение: 17
ЛОГИЧЕСКОЕ ЗНАЧЕНИЕ, используемое с WsCreateChannel для WS_HTTP_CHANNEL_BINDING, WS_TCP_CHANNEL_BINDINGWS_NAMEDPIPE_CHANNEL_BINDING
и WS_UDP_CHANNEL_BINDING.
Используется с WsGetChannelProperty для WS_CUSTOM_CHANNEL_BINDING.


Если это свойство имеет значение TRUE или не задано при вызове WsCreateChannel,
более конкретные свойства времени ожидания канала (например , WS_CHANNEL_PROPERTY_SEND_TIMEOUT)
имеет приоритет и ведет себя так, как описано в документе. Если для этого свойства задано значение FALSE,
для всех свойств времени ожидания канала задано значение INFINITE, если они не указаны явно.


Это свойство можно запросить из настраиваемого канала с помощью WsGetChannelProperty.
Дополнительные сведения см. в разделе WS_GET_CHANNEL_PROPERTY_CALLBACK .


Значение по умолчанию — TRUE.


Чтобы реализовать собственную логику времени ожидания, WS_SERVICE_PROXY и
WS_SERVICE_HOST присваивает этому свойству значение FALSE для
привязки стандартных каналов и требуют, чтобы пользовательские каналы поддерживали их путем запросов и
проверка того, что для него задано значение FALSE.
Более конкретные свойства времени ожидания по-прежнему можно предоставить, как описано выше.
WS_CHANNEL_PROPERTY_TRANSFER_MODE
Значение: 18
Значение WS_TRANSFER_MODE
используется с WsCreateChannel
для WS_HTTP_CHANNEL_BINDING , чтобы управлять сообщениями
Отправленные и полученные по каналу буферистики или потоковой передачи. Клиент
и сервер может использовать различные режимы передачи и по-прежнему иметь возможность обмениваться данными.


Для этого все каналы поддерживают WsGetChannelProperty
.


Для привязок каналов, отличных от WS_HTTP_CHANNEL_BINDING, значение всегда WS_BUFFERED_TRANSFER_MODE.


Значение свойства по умолчанию — WS_BUFFERED_TRANSFER_MODE. Примечание
Модель службы использует только WS_BUFFERED_TRANSFER_MODE для обоих типов.
WS_SERVICE_PROXY и WS_SERVICE_HOST. Единственное исключение
использует контракты сообщений на WS_SERVICE_HOST, где
WS_STREAMED_OUTPUT_TRANSFER_MODE разрешено.



WS_STREAMED_OUTPUT_TRANSFER_MODE с WS_CHANNEL_TYPE_REQUEST требует windows Vista и более поздних версий и поддерживает только WS_HTTP_HEADER_AUTH_SCHEME_BASIC при использовании с безопасностью.
WS_CHANNEL_PROPERTY_MULTICAST_INTERFACE
Значение: 19
ULONG, используемый с WsCreateChannel, WsSetChannelProperty,
или WsGetChannelProperty для WS_UDP_CHANNEL_BINDING
с WS_CHANNEL_TYPE_DUPLEX, чтобы указать, какой адаптер
следует использовать при отправке на адрес многоадресной рассылки.


Значением является индекс интерфейса адаптера.


Если это свойство не задано или равно 0, то адаптер по умолчанию для
используется компьютер. Возможно, это не подходит для компьютеров с несколькими адаптерами.


Это свойство можно задать в любом состоянии канала.


Значение свойства по умолчанию — 0.
WS_CHANNEL_PROPERTY_MULTICAST_HOPS
Значение: 20
ULONG, используемый с WsCreateChannel или WsGetChannelProperty
для WS_UDP_CHANNEL_BINDING с WS_CHANNEL_TYPE_DUPLEX
значение , чтобы указать максимальное количество прыжков, которые может перемещаться UDP-сообщение.


Значение свойства по умолчанию — 1.
WS_CHANNEL_PROPERTY_REMOTE_ADDRESS
Значение: 21
Структура WS_ENDPOINT_ADDRESS
используется с WsGetChannelProperty
для WS_UDP_CHANNEL_BINDING с WS_CHANNEL_TYPE_DUPLEX
, чтобы получить адрес конечной точки удаленной стороны для канала.


Поля возвращаемого объекта
WS_ENDPOINT_ADDRESS структуры являются допустимыми и постоянными до канала
сбрасывается или освобождается. Вызывающий объект не должен изменять значения, возвращаемые
поля WS_ENDPOINT_ADDRESS указывают на.


Это свойство не может быть получено до тех пор, пока канал не достигнет открытого состояния.


Это свойство основано на исходном IP-адресе, полученном от
сеть, которая может быть спуфинирована или изменена, даже если используется
безопасный канал (в зависимости от сетевой среды).
WS_CHANNEL_PROPERTY_REMOTE_IP_ADDRESS
Значение: 22
Структура SOCKADDR_STORAGE
используется с WsCreateChannel
для следующих типов каналов для получения IP-адреса
удаленной стороны:



Это свойство невозможно получить, пока канал не начнет чтение сообщения.


Это свойство основано на исходном IP-адресе, полученном от
сеть, которая может быть спуфинирована или изменена, даже если используется
безопасный канал (в зависимости от сетевой среды).
WS_CHANNEL_PROPERTY_HTTP_CONNECTION_ID
Значение: 23
Указатель на ULONGLONG , используемый с WsGetChannelProperty
для WS_HTTP_CHANNEL_BINDING с WS_CHANNEL_TYPE_REPLY
для получения идентификатора, который однозначно идентифицирует клиентское подключение.


Это свойство невозможно получить, пока канал не начнет чтение сообщения.


Идентификатор подключения однозначно идентифицирует соединение, а
Объект прослушивателя, из который был принят канал, остается открытым.


Данный экземпляр канала ответа никоим образом не связан с подключением.
Каждый раз, когда канал принимается, может быть другой идентификатор подключения.
(даже если общий набор подключений не изменился с момента последнего принятия).


Идентификатор подключения может использоваться приложением для сопоставления состояния с
HTTP-подключение.
WS_CHANNEL_PROPERTY_CUSTOM_CHANNEL_CALLBACKS
Значение: 24
Структура WS_CUSTOM_CHANNEL_CALLBACKS , используемая с WsCreateChannel или WsCreateChannelForListener для WS_CUSTOM_CHANNEL_BINDING.


Это свойство используется для указания обратных вызовов, которые
определить реализацию пользовательского канала.


Это свойство необходимо указать при использовании WS_CUSTOM_CHANNEL_BINDING .
WS_CHANNEL_PROPERTY_CUSTOM_CHANNEL_PARAMETERS
Значение: 25
Указатель на тип данных произвольного размера, используемый с WsCreateChannel или WsCreateChannelForListener для WS_CUSTOM_CHANNEL_BINDING.


Это свойство используется для указания параметров, используемых для создания пользовательского
реализация канала.


Размер свойства — это размер типа данных.


Значение этого свойства будет передано в
WS_CREATE_CHANNEL_CALLBACK.


Если это свойство не указано, его значение равно NULL , а размер равен нулю.
WS_CHANNEL_PROPERTY_CUSTOM_CHANNEL_INSTANCE
Значение: 26
Пустое значение, используемое с WsGetChannelProperty для WS_CUSTOM_CHANNEL_BINDING.


Размер свойства равен sizeof(void) .
Значение соответствует значению экземпляра канала, возвращаемому
WS_CREATE_CHANNEL_CALLBACK.


Это свойство можно использовать для получения базового канала.
экземпляр для пользовательского канала. Это позволяет вызывающей объекту напрямую
взаимодействовать с экземпляром в случаях, когда существующий
недостаточно набора свойств канала или функций канала.
WS_CHANNEL_PROPERTY_TRANSPORT_URL
Значение: 27
Структура WS_STRING
используется с WsGetChannelProperty
для WS_HTTP_CHANNEL_BINDING или WS_TCP_CHANNEL_BINDING для каналов, созданных с помощью WsCreateChannelForListener.


Это свойство используется на сервере для получения переданного URL-адреса.
в WsOpenChannel на клиенте.
Этот URL-адрес может отличаться от значения в WS_TO_HEADER
Значение , если использовался WsAddressMessage . Сопоставление объекта
URL-адрес транспорта для базового транспорта зависит от
WS_CHANNEL_BINDING следующим образом:




  • WS_HTTP_CHANNEL_BINDING. URL-адрес транспорта:
    URL-адрес запроса.


  • WS_TCP_CHANNEL_BINDING. URL-адрес транспорта:
    URL-адрес, который присутствует на уровне обрамления .NET.


Это свойство доступно только после того, как канал имеет
принимается с помощью WsAcceptChannel.


Вызывающий объект должен передать адрес WS_STRING , когда
получение этого свойства. Возвращаемая строка является полной
URL-адрес в закодированном виде. Возвращаемая строка является хорошей до канала
освобождается или сбрасывается.
WS_CHANNEL_PROPERTY_NO_DELAY
Значение: 28
BoOL, используемый с WsCreateChannel, WsCreateChannelForListener или WsGetChannelProperty или WsSetChannelProperty для WS_TCP_CHANNEL_BINDING.


Это свойство управляет значением параметра TCP_NODELAY сокета базового сокета.


Если это значение равно FALSE, используется алгоритм Nagle, который может
повышение пропускной способности путем объединения небольших сообщений.


Установка значения TRUE может уменьшить задержку за счет пропускной способности.
для небольших сообщений.


Значение по умолчанию — FALSE.
WS_CHANNEL_PROPERTY_SEND_KEEP_ALIVES
Значение: 29
BoOL, используемый с WsCreateChannel, WsCreateChannelForListener для WS_TCP_CHANNEL_BINDING.


Это свойство управляет значением параметра SO_KEEPALIVE сокета базового сокета.


Установка значения TRUE приведет к отправке пакетов проверки активности.
в базовом сокете, который может помочь определить, когда
удаленная сторона больше не доступна.


Значение по умолчанию — FALSE.
WS_CHANNEL_PROPERTY_KEEP_ALIVE_TIME
Значение: 30
Объект ULONG, используемый с WsCreateChannel или WsCreateChannelForListener для WS_TCP_CHANNEL_BINDING.


Это свойство измеряется в миллисекундах.


Это свойство может быть указано только в том случае, если свойство WS_CHANNEL_PROPERTY_SEND_KEEP_ALIVES имеет значение TRUE.


Значение представляет количество времени до отправки пакетов keep в активном состоянии, если
сокет не используется.


Значение по умолчанию — 2 часа.
WS_CHANNEL_PROPERTY_KEEP_ALIVE_INTERVAL
Значение: 31
Объект ULONG, используемый с WsCreateChannel или WsCreateChannelForListener для WS_TCP_CHANNEL_BINDING.


Это свойство измеряется в миллисекундах.


Это свойство может быть указано только в том случае, если свойство WS_CHANNEL_PROPERTY_SEND_KEEP_ALIVES имеет значение TRUE.


По истечении времени, указанного в WS_CHANNEL_PROPERTY_KEEP_ALIVE_TIME ,
система начнет отправлять пакеты keep alive в попытке связаться
удаленная сторона. Этот параметр определяет частоту отправки системой.
другой пакет (как повторная попытка).


Значение по умолчанию — 1 секунда.
WS_CHANNEL_PROPERTY_MAX_HTTP_SERVER_CONNECTIONS
Значение: 32
ULONG, используемый с WsCreateChannel для WS_HTTP_CHANNEL_BINDING.


Это свойство задает максимальное количество подключений клиентского приложения.
может иметь значение для HTTP-сервера.
Подключения могут кэшироваться и повторно использоваться другими компонентами в рамках того же процесса, обращающийся к тому же HTTP-серверу.


Значение по умолчанию — INFINITE (без ограничений).
WS_CHANNEL_PROPERTY_IS_SESSION_SHUT_DOWN
Значение: 33
ЛОГИЧЕСКОЕ ЗНАЧЕНИЕ, используемое с WsGetChannelProperty для WS_TCP_CHANNEL_BINDING
или WS_NAMEDPIPE_CHANNEL_BINDING с WS_CHANNEL_TYPE_DUPLEX_SESSION.


Это свойство указывает
имеет ли WsShutdownSessionChannel
используется для завершения работы канала.


Канал должен находиться в WS_CHANNEL_STATE_OPEN или
состояние WS_CHANNEL_STATE_FAULTED .
WS_CHANNEL_PROPERTY_CHANNEL_TYPE
Значение: 34
Значение WS_CHANNEL_TYPE
используется с WsGetChannelProperty для всех типов каналов
, чтобы запросить тип канала.


Канал может находиться в любом WS_CHANNEL_STATE.
WS_CHANNEL_PROPERTY_TRIM_BUFFERED_MESSAGE_SIZE
Значение: 35
ULONG, используемый с WsCreateChannel, WsCreateChannelForListener или
WsGetChannelProperty для WS_TCP_CHANNEL_BINDING,
WS_HTTP_CHANNEL_BINDING или WS_NAMEDPIPE_CHANNEL_BINDING для управления выделением памяти
характеристики сообщений в канале.


Это свойство указывает максимальный объем памяти, который будет храниться в канале
вокруг после сброса сообщения. Если все
все сообщения, которые видит канал, меньше, чем этот размер, а затем выделения
для буферизации сообщения будут сведены к минимуму.


Это свойство может быть указано только в том случае, если буферизация входных или выходных данных имеет значение
указано ( WS_STREAMED_INPUT_TRANSFER_MODE или
WS_STREAMED_OUTPUT_TRANSFER_MODE не задано).


Значение по умолчанию — 65536.


В WS_UDP_CHANNEL_BINDING всегда используется значение 65536.
WS_CHANNEL_PROPERTY_ENCODER
Значение: 36
Структура WS_CHANNEL_ENCODER , используемая с WsCreateChannel или WsCreateChannelForListener для WS_TCP_CHANNEL_BINDING.
WS_HTTP_CHANNEL_BINDING или WS_NAMEDPIPE_CHANNEL_BINDING для предоставления настраиваемой кодировки сообщений.

Это свойство нельзя использовать с WS_UDP_CHANNEL_BINDING.
WS_CHANNEL_PROPERTY_DECODER
Значение: 37
Структура WS_CHANNEL_DECODER , используемая с WsCreateChannel или WsCreateChannelForListener для WS_TCP_CHANNEL_BINDING.
WS_HTTP_CHANNEL_BINDING или WS_NAMEDPIPE_CHANNEL_BINDING для предоставления настраиваемого декодирования сообщений.

Это свойство нельзя использовать с WS_UDP_CHANNEL_BINDING.
WS_CHANNEL_PROPERTY_PROTECTION_LEVEL
Значение: 38
Значение WS_PROTECTION_LEVEL , используемое с WsGetChannelProperty для любого типа канала.


Это свойство указывает
гарантии безопасности, предоставляемые каналом.


Значение этого свойства зависит от требований к безопасности.
запрашивается для канала.
WS_CHANNEL_PROPERTY_COOKIE_MODE
Значение: 39
Значение WS_COOKIE_MODE , используемое с WsCreateChannel с WS_HTTP_CHANNEL_BINDING для управления обработкой файлов cookie HTTP.


Значение по умолчанию — WS_AUTO_COOKIE_MODE.
WS_CHANNEL_PROPERTY_HTTP_PROXY_SETTING_MODE
Значение: 40
Значение WS_HTTP_PROXY_SETTING_MODE , используемое с WsCreateChannel с WS_HTTP_CHANNEL_BINDING для управления параметрами прокси-сервера HTTP для канала.


Значение по умолчанию — WS_HTTP_PROXY_SETTING_MODE_AUTO.
WS_CHANNEL_PROPERTY_CUSTOM_HTTP_PROXY
Значение: 41
Структура WS_CUSTOM_HTTP_PROXY , используемая с WsCreateChannel с WS_HTTP_CHANNEL_BINDING для указания настраиваемого параметра для канала HTTP. Это свойство должно
указывается, если для WS_CHANNEL_PROPERTY_HTTP_PROXY_SETTING_MODE задано значение
WS_HTTP_PROXY_SETTING_MODE_CUSTOM.


Значение по умолчанию — NULL.
WS_CHANNEL_PROPERTY_HTTP_MESSAGE_MAPPING
Значение: 42
Структура WS_HTTP_MESSAGE_MAPPING , используемая с WsCreateChannel или WsCreateChannelForListener для WS_HTTP_CHANNEL_BINDING.


Это значение свойства определяет способ сопоставления HTTP-запроса или ответа с
объект сообщения. Дополнительные сведения см. в разделе WS_HTTP_MESSAGE_MAPPING .


По умолчанию для этого свойства используется WS_HTTP_MESSAGE_MAPPING структура выглядит следующим образом:



  • requestMappingOptions: 0

  • requestHeaderMappings: none

  • responseMappingOptions: 0

  • responseHeaderMappings: none



WS_HTTP_MESSAGE_MAPPING поля requestMappingOptions и responseMappingOptions должны иметь значение 0
Если для кодировки не задано значение WS_ENCODING_RAW с помощью свойства канала WS_CHANNEL_PROPERTY_ENCODING.
WS_CHANNEL_PROPERTY_ENABLE_HTTP_REDIRECT
Значение: 43
ЛОГИЧЕСКОЕ ЗНАЧЕНИЕ, используемое с WsCreateChannel для WS_HTTP_CHANNEL_BINDING с WS_CHANNEL_TYPE_REQUEST.


Это значение свойства определяет, включено ли автоматическое перенаправление HTTP.


Если задать для этого значения значение TRUE , вы активируете автоматическое перенаправление HTTP.


Значение по умолчанию — FALSE.
Если указано свойство WS_CHANNEL_PROPERTY_HTTP_REDIRECT_CALLBACK_CONTEXT ,
Это свойство игнорируется.
WS_CHANNEL_PROPERTY_HTTP_REDIRECT_CALLBACK_CONTEXT
Значение: 44
Структура WS_HTTP_REDIRECT_CALLBACK_CONTEXT
используется с WsCreateChannel для WS_HTTP_CHANNEL_BINDING с WS_CHANNEL_TYPE_REQUEST.


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


Если это свойство задано, будет вызвана указанная подпрограмма обратного вызова с исходным URL-адресом конечной точки.
и новый URL-адрес, на который будет перенаправлено сообщение. Возвращаемое значение обратного вызова используется для указания того, используется ли
перенаправление должно быть разрешено.
WS_CHANNEL_PROPERTY_FAULTS_AS_ERRORS
Значение: 45
BOOL, используемый с WsCreateChannel, WsSetChannelProperty,
WsGetChannelProperty или WsCreateServiceProxy для WS_HTTP_CHANNEL_BINDING и WS_CHANNEL_TYPE_REQUEST или WS_TCP_CHANNEL_BINDING, WS_NAMEDPIPE_CHANNEL_BINDING и WS_UDP_CHANNEL_BINDING на клиенте.


Если задано значение TRUE, функции channel и service model возвращают код ошибки при получении ошибки.
Если эта среда выполнения распознает ошибку, возвращается соответствующий код ошибки.
в противном случае возвращается WS_E_ENDPOINT_FAULT_RECEIVED . (См. раздел Возвращаемые значения веб-служб Windows.) Если задано значение FALSE, WsReceiveMessage
и WsRequestReply возвращают WS_E_ENDPOINT_FAULT_RECEIVED при получении ошибки.
Другие функции канала возвращают ошибки в виде обычных сообщений и WS_MESSAGE_PROPERTY_IS_FAULT
может использоваться для отличия ошибок от других сообщений.


Если для этого свойства задано значение TRUE и используется с WsCreateChannel или WsSetChannelProperty,
переопределяет следующее поведение WS_CHANNEL_PROPERTY_ALLOW_UNSECURED_FAULTS: если ошибка распознана
среда выполнения, незащищенная ошибка не приведет к сбою проверки безопасности сообщения об ошибке, даже если
WS_CHANNEL_PROPERTY_ALLOW_UNSECURED_FAULTS задано значение FALSE. Состояние проверки безопасности
можно определить, проверив WS_MESSAGE_PROPERTY_PROTECTION_LEVEL.
Это не относится к WS_UDP_CHANNEL_BINDING , так как не поддерживает безопасность.


Если это свойство имеет значение FALSE или используется с WsCreateServiceProxy или ошибка не распознана
в среде выполнения поведение, описанное в WS_CHANNEL_PROPERTY_ALLOW_UNSECURED_FAULTS применяется без
.


Независимо от значения этого свойства, если код ошибки возвращается в результате получения ошибки,
WsGetFaultErrorProperty можно использовать для запроса сведений об ошибке из объекта ошибки.


Это свойство можно задать в любом состоянии канала.


Значение по умолчанию — TRUE. При использовании с WsCreateServiceProxy это свойство должно иметь значение TRUE.




Установка для этого свойства значения TRUE может привести к отключению проверки безопасности сообщений для определенных ошибок.
Непроверенные ошибки могут быть ненадежны.
WS_CHANNEL_PROPERTY_ALLOW_UNSECURED_FAULTS
Значение: 46
BOOL, используемый с WsCreateChannel, WsSetChannelProperty,
или WsGetChannelProperty для WS_HTTP_CHANNEL_BINDING и WS_CHANNEL_TYPE_REQUEST либо WS_TCP_CHANNEL_BINDING и WS_NAMEDPIPE_CHANNEL_BINDING на клиенте.


Если задано значение TRUE, незащищенные ошибки, полученные в защищенном канале, не приводят к сбою проверки безопасности сообщений. Вместо
Ошибка будет рассматриваться как если бы проверка безопасности сообщения прошла успешно, и она будет обрабатываться, как описано в WS_CHANNEL_PROPERTY_FAULTS_AS_ERRORS.
Состояние проверки безопасности можно определить, проверив WS_MESSAGE_PROPERTY_PROTECTION_LEVEL.


Если задано значение FALSE, проверка безопасности сообщений об ошибках обрабатывается аналогично проверке любого другого сообщения.


WS_CHANNEL_PROPERTY_FAULTS_AS_ERRORS может переопределить это свойство для ошибок, распознаваемых этой средой выполнения.


Это свойство применяется только к проверке безопасности на уровне сообщений и не влияет на безопасность транспорта.


Это свойство можно задать в любом состоянии канала.


Значение по умолчанию — FALSE.


Установка для этого свойства значения TRUE приводит к отключению проверки безопасности сообщений на наличие ошибок. Незащищенные ошибки могут быть ненадежны.
WS_CHANNEL_PROPERTY_HTTP_SERVER_SPN
Значение: 47
Указатель WCHAR
используется с WsGetChannelProperty для WS_HTTP_CHANNEL_BINDING и WS_CHANNEL_TYPE_REQUEST.



Возвращает имя участника-сервера удаленной конечной точки, используемой для последнего неудачного запроса. Нет никакой гарантии, что это свойство имеет значение
объекте. Ниже приведены необходимые (но не всегда достаточные) условия для этого свойства:

  • Канал отправил запрос.

  • Сбой запроса из-за несоответствия схем проверки подлинности заголовка HTTP. См . WS_HTTP_HEADER_AUTH_SECURITY_BINDING.

  • Удаленная конечная точка поддерживает схему проверки подлинности Nego2.




Это свойство доступно только в Windows 7 и более поздних версиях.
WS_CHANNEL_PROPERTY_HTTP_PROXY_SPN
Значение: 48
Указатель WCHAR , используемый с WsGetChannelProperty для WS_HTTP_CHANNEL_BINDING и WS_CHANNEL_TYPE_REQUEST.



Возвращает имя участника-сервера прокси-сервера HTTP, используемого для последнего неудачного запроса. Нет никакой гарантии, что это свойство имеет значение
объекте. Ниже приведены необходимые (но не всегда достаточные) условия для этого свойства:

  • Канал отправил запрос.

  • Сбой запроса из-за несоответствия схем проверки подлинности заголовка HTTP. См . WS_HTTP_HEADER_AUTH_SECURITY_BINDING.

  • Прокси-сервер HTTP поддерживает схему проверки подлинности Nego2.




Это свойство доступно только в Windows 7 и более поздних версиях.
WS_CHANNEL_PROPERTY_MAX_HTTP_REQUEST_HEADERS_BUFFER_SIZE
Значение: 49
ULONG, используемый с WsCreateChannelForListener или
WsGetChannelProperty для WS_HTTP_CHANNEL_BINDING
с WS_CHANNEL_TYPE_REPLY. Это значение является ограничением на размер заголовков.
может быть получен HTTP-запрос. Ограничение указывает максимальный размер
заголовков HTTP-запросов в байтах.


Это свойство ограничивает объем памяти
что WS_HTTP_CHANNEL_BINDING с WS_CHANNEL_TYPE_REPLY
выделяется для получения заголовков HTTP-запросов. При получении весь HTTP-запрос
заголовки считываются в буфер перед обработкой.


Значение по умолчанию — 65536.

Требования

   
Минимальная версия клиента Windows 7 [классические приложения | Приложения UWP]
Минимальная версия сервера Windows Server 2008 R2 [классические приложения | Приложения UWP]
Верхняя часть webservices.h