Compartir a través de

enumeración WS_CHANNEL_PROPERTY_ID (webservices.h)

  • Artículo

Cada propiedad de canal se identifica mediante un identificador y tiene un valor asociado. Si no se especifica una propiedad cuando se crea el canal, se usa su valor predeterminado.

Syntax

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;

Constantes

 
WS_CHANNEL_PROPERTY_MAX_BUFFERED_MESSAGE_SIZE
Valor: 0
Una ULONG
se usa con WsCreateChannel, WsCreateChannelForListener o
WsGetChannelProperty para WS_TCP_CHANNEL_BINDING,
WS_HTTP_CHANNEL_BINDING o WS_NAMEDPIPE_CHANNEL_BINDING. Este valor es un límite en cuanto al tamaño de un
el canal puede recibir o enviar el mensaje. El límite especifica el tamaño máximo.
del sobre en bytes tal y como aparece en su forma de cable codificada.
El valor mínimo es 1.


Esta propiedad limita la cantidad de memoria.
que el canal asignará para recibir o enviar un mensaje almacenado en búfer.
Al recibir con entrada almacenada en búfer, se lee todo el mensaje en un
búfer antes de que la aplicación tenga acceso a ella. Al enviar con salida almacenada en búfer,
todo el mensaje se acumula en un búfer antes de enviarse.


Esta propiedad solo se puede especificar cuando se ha almacenado en búfer la entrada o salida
especificado ( ya sea WS_STREAMED_INPUT_TRANSFER_MODE o
WS_STREAMED_OUTPUT_TRANSFER_MODE no se han establecido).


El valor predeterminado es 65536.


El WS_UDP_CHANNEL_BINDING siempre usa el valor 65536.
WS_CHANNEL_PROPERTY_MAX_STREAMED_MESSAGE_SIZE
Valor: 1
Un __int64 sin signo usado con WsCreateChannel, WsCreateChannelForListener o
WsGetChannelProperty
WS_HTTP_CHANNEL_BINDING. Este
value es un límite en cuanto al tamaño de un mensaje transmitido que se puede recibir o enviar
para el canal.
El límite especifica el tamaño máximo del sobre en bytes tal y como aparece.
en su forma de cable codificada. El valor mínimo es 1.


Esta propiedad solo se puede especificar cuando se ha seleccionado la entrada o salida transmitidas
(WS_STREAMED_INPUT_TRANSFER_MODE o WS_STREAMED_OUTPUT_TRANSFER_MODE se ha establecido).


El valor predeterminado es 4194304.
WS_CHANNEL_PROPERTY_MAX_STREAMED_START_SIZE
Valor: 2
Una ULONG usada con WsCreateChannel, WsCreateChannelForListener o
WsGetChannelProperty para WS_HTTP_CHANNEL_BINDING.
Este valor es un límite en cuanto al tamaño que puede tener el inicio de un mensaje.
El inicio de un mensaje consta de la etiqueta envelope, los encabezados y la etiqueta body.
El límite especifica el tamaño máximo de los datos en bytes tal y como aparece en
su forma de cable codificada. El valor mínimo es 1.


Esta propiedad solo se puede especificar cuando se ha seleccionado la entrada transmitida
(WS_STREAMED_INPUT_TRANSFER_MODE).


Esta propiedad limita la cantidad de memoria que asignará el canal.
para leer el inicio del mensaje. Para la entrada de streaming,
se leerá todo el inicio del mensaje en un búfer antes de la aplicación.
se notifica que se ha leído el inicio del mensaje.


El valor predeterminado es 16384.
WS_CHANNEL_PROPERTY_MAX_STREAMED_FLUSH_SIZE
Valor: 3
Una ULONG usada con WsCreateChannel, WsCreateChannelForListener o
WsGetChannelProperty para WS_HTTP_CHANNEL_BINDING.
Este valor es un límite en cuanto al número de bytes que se acumularán.
antes de llamar a WsFlushBody .


Esta propiedad solo se puede especificar cuando se ha seleccionado la salida transmitida
(WS_STREAMED_OUTPUT_TRANSFER_MODE).


Esta propiedad limita la cantidad de memoria que asignará el canal.
para acumular datos almacenados en búfer. Para la salida de streaming,
channel acumulará datos en un búfer hasta que se llame a WsFlushBody .


El valor predeterminado es 65536.
WS_CHANNEL_PROPERTY_ENCODING
Valor: 4
Valor de WS_ENCODING
se usa con WsCreateChannel, WsCreateChannelForListener o WsGetChannelProperty para WS_TCP_CHANNEL_BINDING o WS_HTTP_CHANNEL_BINDING.
Este valor especifica la codificación que se va a usar para el canal.


El valor predeterminado depende del enlace:



El WS_UDP_CHANNEL_BINDING siempre usa el valor WS_ENCODING_XML_UTF8.
WS_CHANNEL_PROPERTY_ENVELOPE_VERSION
Valor: 5
Valor de WS_ENVELOPE_VERSION
se usa con WsCreateChannel, WsCreateChannelForListener o WsGetChannelProperty.
Este valor especifica qué versión de sobre se va a usar para el canal. The
La versión de sobre del canal debe coincidir con la del mensaje usado con
el canal.


Esta propiedad no se admite con el WS_NAMEDPIPE_CHANNEL_BINDING. Los canales de canalización con nombre siempre usan WS_ENVELOPE_VERSION_SOAP_1_2.

El valor predeterminado depende del enlace:
WS_CHANNEL_PROPERTY_ADDRESSING_VERSION
Valor: 6
Valor de WS_ADDRESSING_VERSION
se usa con WsCreateChannel, WsCreateChannelForListener o WsGetChannelProperty.
Este valor especifica qué versión de direccionamiento se va a usar para el canal. The
la versión de direccionamiento del canal debe coincidir con la del mensaje usado con
el canal.


El valor predeterminado depende del enlace:



El WS_ADDRESSING_VERSION_TRANSPORT solo se admite para
WS_HTTP_CHANNEL_BINDING.
WS_CHANNEL_PROPERTY_MAX_SESSION_DICTIONARY_SIZE
Valor: 7
ULONG usado con WsCreateChannel, WsCreateChannelForListener o WsGetChannelProperty.
Esta propiedad solo es válida para WS_TCP_CHANNEL_BINDING o WS_NAMEDPIPE_CHANNEL_BINDING.
Este valor especifica la cuota del número de bytes del diccionario de sesión.
cadenas que se transmitirán o recibirán al usar una codificación basada en sesión.


La única codificación basada en sesión admitida actualmente es
WS_ENCODING_XML_BINARY_SESSION_1, que es la codificación predeterminada
para el WS_TCP_CHANNEL_BINDING.


Si se alcanza la cuota en el lado receptor, el canal
se producirá un error.


Si se alcanza la cuota en el lado de envío, el canal simplemente
transmita la cadena sin usar el diccionario de sesión.


Este valor se omite si no usa una codificación basada en sesión.


El valor predeterminado es 2048.
WS_CHANNEL_PROPERTY_STATE
Valor: 8
Un valor de WS_CHANNEL_STATE
devuelto por WsGetChannelProperty.


El valor devuelto es una instantánea del estado actual, por lo que es
posible que el estado haya cambiado antes de que el autor de la llamada tenga
tuvo la oportunidad de examinar el valor.
WS_CHANNEL_PROPERTY_ASYNC_CALLBACK_MODEL
Valor: 9
Valor de WS_CALLBACK_MODEL usado con WsCreateChannel o WsGetChannelProperty.
Este valor indica el modelo de devolución de llamada asincrónico preferido al emitir
Operaciones asincrónicas para el canal.


Si usa WsCreateChannelForListener , consulte
WS_LISTENER_PROPERTY_ASYNC_CALLBACK_MODEL.


El valor predeterminado es WS_LONG_CALLBACK.


Tanto el WS_SERVICE_HOST como el WS_SERVICE_PROXY solo admiten WS_LONG_CALLBACK
como un valor aceptable para esta propiedad.
WS_CHANNEL_PROPERTY_IP_VERSION
Valor: 10
Valor de WS_IP_VERSION
se usa con WsCreateChannel o WsGetChannelProperty para WS_TCP_CHANNEL_BINDING o WS_UDP_CHANNEL_BINDING.
Esta propiedad especifica la versión IP que el canal debe usar para
comunicarse con el punto de conexión remoto.


Para especificar la versión de IP que se va a usar para los canales que se aceptan, use el
WS_LISTENER_PROPERTY_IP_VERSION propiedad de agente de escucha cuando
crear el objeto de agente de escucha.


El valor predeterminado es WS_IP_VERSION_AUTO.
WS_CHANNEL_PROPERTY_RESOLVE_TIMEOUT
Valor: 11
Un ULONG usado con WsCreateChannel, WsSetChannelProperty,
o WsSetChannelProperty para WS_HTTP_CHANNEL_BINDING y WS_CHANNEL_TYPE_REQUEST.
Este tiempo de espera limita la cantidad de tiempo que se dedicará a resolver
el nombre DNS. El valor de tiempo de espera está en milisegundos,
donde el valor INFINITE indica que no se ha agotado el tiempo de espera.


Esta propiedad se puede establecer en cualquier estado de canal.


El valor predeterminado es INFINITE.
WS_CHANNEL_PROPERTY_CONNECT_TIMEOUT
Valor: 12
Un ULONG usado con WsCreateChannel,
WsSetChannelProperty o WsGetChannelProperty
para WS_TCP_CHANNEL_BINDING o WS_NAMEDPIPE_CHANNEL_BINDING en el lado cliente.
Este tiempo de espera limita la cantidad de tiempo que se dedicará a conectarse a la máquina remota y completar el protocolo de enlace net.tcp o net.pipe. Valor de tiempo de espera
está en milisegundos, donde el valor INFINITE indica que no se ha agotado el tiempo de espera. Para establecer
u obtenga el tiempo de espera correspondiente en el lado servidor, use
(WS_LISTENER_PROPERTY_CONNECT_TIMEOUT).


Se usa con WsCreateChannel,
WsSetChannelProperty o WsGetChannelProperty para WS_HTTP_CHANNEL_BINDING y WS_CHANNEL_TYPE_REQUEST.
Este tiempo de espera limita la cantidad de tiempo que se dedicará a conectarse.
al servidor HTTP. El valor de tiempo de espera está en milisegundos,
donde el valor INFINITE indica que no se ha agotado el tiempo de espera.


Esta propiedad se puede establecer en cualquier estado de canal.


El valor predeterminado es 30000 (30 segundos).


El WS_SERVICE_PROXY establece este tiempo de espera en INFINITE de forma predeterminada.
WS_CHANNEL_PROPERTY_SEND_TIMEOUT
Valor: 13
ULONG usado con WsCreateChannel, WsCreateChannelForListener,
WsSetChannelProperty o WsGetChannelProperty
para WS_TCP_CHANNEL_BINDING o WS_NAMEDPIPE_CHANNEL_BINDING. Este tiempo de espera limita el
cantidad de tiempo que se dedicará a enviar los bytes del mensaje.
El valor de tiempo de espera está en milisegundos, donde el valor INFINITE indica.
no hay tiempo de espera.


Se usa con WsCreateChannel, WsSetChannelProperty,
o WsGetChannelProperty para WS_HTTP_CHANNEL_BINDING
y WS_CHANNEL_TYPE_REQUEST.
Este tiempo de espera limita la cantidad de tiempo que se dedicará a enviar el
Encabezados HTTP y bytes del mensaje. El valor de tiempo de espera está en milisegundos, donde
value INFINITE indica que no se ha agotado el tiempo de espera.


Esta propiedad se puede establecer en cualquier estado de canal.


El valor predeterminado es 30000 (30 segundos).


Tanto WS_SERVICE_HOST como WS_SERVICE_PROXY establecen esto
tiempo de espera en INFINITE de forma predeterminada.
WS_CHANNEL_PROPERTY_RECEIVE_RESPONSE_TIMEOUT
Valor: 14
Un ULONG usado con WsCreateChannel, WsSetChannelProperty,
o WsSetChannelProperty para WS_HTTP_CHANNEL_BINDING y WS_CHANNEL_TYPE_REQUEST.
Este tiempo de espera limita la cantidad de tiempo que se dedicará a esperar
todos los encabezados de respuesta que se van a recibir del servidor.
El valor de tiempo de espera está en milisegundos, donde el valor INFINITE indica que no se ha agotado el tiempo de espera.


Esta propiedad se puede establecer en cualquier estado de canal.


El valor predeterminado es 30000 (30 segundos).


El WS_SERVICE_PROXY establece este tiempo de espera en INFINITE.
WS_CHANNEL_PROPERTY_RECEIVE_TIMEOUT
Valor: 15
ULONG usado con WsCreateChannel, WsCreateChannelForListener,
WsSetChannelProperty o WsGetChannelProperty,
para WS_TCP_CHANNEL_BINDING o WS_NAMEDPIPE_CHANNEL_BINDING.
Este tiempo de espera limita la cantidad de tiempo que se dedicará a recibir el
bytes del mensaje.
El valor de tiempo de espera está en milisegundos, donde el valor INFINITE indica.
no hay tiempo de espera.


Se usa con WsCreateChannel, WsSetChannelProperty,
o WsGetChannelProperty para WS_HTTP_CHANNEL_BINDING y WS_CHANNEL_TYPE_REQUEST.
Este tiempo de espera limita la cantidad de tiempo que se dedicará a recibir el
bytes del mensaje. El valor de tiempo de espera está en milisegundos,
donde el valor INFINITE indica que no se ha agotado el tiempo de espera.
WsWriteMessageEnd, WsReadMessageStart y WsReadMessageEnd pueden desencadenar este tiempo de espera.

Esta propiedad se puede establecer en cualquier estado de canal.


El valor predeterminado es 30000 (30 segundos).


Tanto WS_SERVICE_HOST como WS_SERVICE_PROXY establecen esto
tiempo de espera en INFINITE de forma predeterminada.
WS_CHANNEL_PROPERTY_CLOSE_TIMEOUT
Valor: 16
Un ULONG usado con WsCreateChannel, WsCreateChannelForListener
WsSetChannelProperty o WsGetChannelProperty
para WS_TCP_CHANNEL_BINDING o WS_NAMEDPIPE_CHANNEL_BINDING.
Este tiempo de espera limita la cantidad de tiempo que se dedicará a completar el
el protocolo de enlace de cierre net.tcp o net.pipe. El valor de tiempo de espera está en milisegundos, donde
value INFINITE indica que no se ha agotado el tiempo de espera.


Esta propiedad se puede establecer en cualquier estado de canal.


El valor predeterminado es 30000 (30 segundos).


El WS_SERVICE_PROXY establece este tiempo de espera en INFINITE de forma predeterminada.
WS_CHANNEL_PROPERTY_ENABLE_TIMEOUTS
Valor: 17
BoOL usado con WsCreateChannel para WS_HTTP_CHANNEL_BINDING, WS_TCP_CHANNEL_BINDING, WS_NAMEDPIPE_CHANNEL_BINDING,
y WS_UDP_CHANNEL_BINDING.
Se usa con WsGetChannelProperty para WS_CUSTOM_CHANNEL_BINDING.


Cuando esta propiedad se establece en TRUE o no se proporciona al llamar a WsCreateChannel,
propiedades de tiempo de espera de canal más específicas (por ejemplo , WS_CHANNEL_PROPERTY_SEND_TIMEOUT)
tiene prioridad y se comporta como se documenta. Cuando esta propiedad se establece en FALSE,
todas las propiedades específicas de tiempo de espera del canal se establecen en INFINITE a menos que se especifiquen explícitamente.


Esta propiedad se puede consultar desde un canal personalizado mediante WsGetChannelProperty,
consulte WS_GET_CHANNEL_PROPERTY_CALLBACK para obtener más detalles.


El valor predeterminado es TRUE.


Para implementar su propia lógica de tiempo de espera, WS_SERVICE_PROXY y
WS_SERVICE_HOST establece esta propiedad en FALSE para .
enlaces de canales estándar y requieren canales personalizados para admitirlo consultando y
comprobando que está establecido en FALSE.
Las propiedades de tiempo de espera más específicas todavía se pueden proporcionar como se describió anteriormente.
WS_CHANNEL_PROPERTY_TRANSFER_MODE
Valor: 18
Valor de WS_TRANSFER_MODE
se usa con WsCreateChannel
para WS_HTTP_CHANNEL_BINDING controlar si los mensajes
enviados y recibidos en el canal se almacenan en búfer o se transmiten. El cliente
y el servidor pueden usar diferentes modos de transferencia y seguir siendo capaces de comunicarse.


Todos los canales admiten WsGetChannelProperty para este
propiedad.


Para los enlaces de canal distintos de WS_HTTP_CHANNEL_BINDINGel valor siempre se WS_BUFFERED_TRANSFER_MODE.


El valor de propiedad predeterminado es WS_BUFFERED_TRANSFER_MODE. Nota
solo el modelo de servicio usa WS_BUFFERED_TRANSFER_MODE para ambos
WS_SERVICE_PROXY y WS_SERVICE_HOST. La única excepción
está alrededor del uso de contratos de mensajes en WS_SERVICE_HOST, donde
WS_STREAMED_OUTPUT_TRANSFER_MODE se permite.



WS_STREAMED_OUTPUT_TRANSFER_MODE con WS_CHANNEL_TYPE_REQUEST requiere Windows Vista y versiones posteriores, y solo admite WS_HTTP_HEADER_AUTH_SCHEME_BASIC cuando se usa con seguridad.
WS_CHANNEL_PROPERTY_MULTICAST_INTERFACE
Valor: 19
Un ULONG usado con WsCreateChannel, WsSetChannelProperty,
o WsGetChannelProperty para WS_UDP_CHANNEL_BINDING
con WS_CHANNEL_TYPE_DUPLEX para indicar qué adaptador
se debe usar al enviar a una dirección de multidifusión.


El valor es el índice de interfaz del adaptador.


Si esta propiedad no está establecida o es 0, el adaptador predeterminado para el
se usa la máquina. Esto puede no ser adecuado para las máquinas con varios adaptadores.


Esta propiedad se puede establecer en cualquier estado de canal.


El valor de propiedad predeterminado es 0.
WS_CHANNEL_PROPERTY_MULTICAST_HOPS
Valor: 20
ULONG usado con WsCreateChannel o WsGetChannelProperty
para WS_UDP_CHANNEL_BINDING con WS_CHANNEL_TYPE_DUPLEX
para especificar el número máximo de saltos que puede viajar un mensaje UDP.


El valor de propiedad predeterminado es 1.
WS_CHANNEL_PROPERTY_REMOTE_ADDRESS
Valor: 21
Estructura de WS_ENDPOINT_ADDRESS
se usa con WsGetChannelProperty
para WS_UDP_CHANNEL_BINDING con WS_CHANNEL_TYPE_DUPLEX
para recuperar la dirección del punto de conexión de la entidad remota para el canal.


Campos del devuelto
WS_ENDPOINT_ADDRESS estructura son válidas y constantes hasta que el canal
se restablece o libera. El autor de la llamada no debe modificar los valores devueltos
campos del punto de WS_ENDPOINT_ADDRESS .


Esta propiedad no se puede recuperar hasta que el canal haya alcanzado el estado abierto.


Esta propiedad se basa en la dirección IP de origen que se recibe de .
la red, que se puede suplantar o alterar, incluso si se usa una
canal seguro (según el entorno de red).
WS_CHANNEL_PROPERTY_REMOTE_IP_ADDRESS
Valor: 22
Estructura de SOCKADDR_STORAGE
se usa con WsCreateChannel
para los siguientes tipos de canales para recuperar la dirección IP
de la entidad remota:



Esta propiedad no se puede recuperar hasta que el canal haya comenzado a leer un mensaje.


Esta propiedad se basa en la dirección IP de origen de la que se recibe
la red, que se puede suplantar o alterar incluso si se usa un
canal seguro (según el entorno de red).
WS_CHANNEL_PROPERTY_HTTP_CONNECTION_ID
Valor: 23
Puntero a un ULONGLONG usado con WsGetChannelProperty
para WS_HTTP_CHANNEL_BINDING con WS_CHANNEL_TYPE_REPLY
para recuperar un identificador que identifica de forma única la conexión de cliente.


Esta propiedad no se puede recuperar hasta que el canal haya comenzado a leer un mensaje.


El identificador de conexión identifica de forma única una conexión mientras
El objeto de agente de escucha del que se aceptó el canal permanece abierto.


Una instancia de canal de respuesta determinada no está correlacionada de ninguna manera con una conexión.
Cada vez que se acepta el canal, puede haber un identificador de conexión diferente.
(incluso si el conjunto total de conexiones no ha cambiado desde la última aceptación).


Una aplicación puede usar el identificador de conexión para correlacionar el estado con
una conexión HTTP.
WS_CHANNEL_PROPERTY_CUSTOM_CHANNEL_CALLBACKS
Valor: 24
Estructura WS_CUSTOM_CHANNEL_CALLBACKS usada con WsCreateChannel o WsCreateChannelForListener para WS_CUSTOM_CHANNEL_BINDING.


Esta propiedad se usa para especificar devoluciones de llamada que
defina la implementación de un canal personalizado.


Esta propiedad debe especificarse cuando se usa WS_CUSTOM_CHANNEL_BINDING .
WS_CHANNEL_PROPERTY_CUSTOM_CHANNEL_PARAMETERS
Valor: 25
Puntero a un tipo de datos de tamaño arbitrario usado con WsCreateChannel o WsCreateChannelForListener para WS_CUSTOM_CHANNEL_BINDING.


Esta propiedad se usa para especificar los parámetros usados para crear el personalizado.
implementación del canal.


El tamaño de la propiedad es el tamaño del tipo de datos.


El valor de esta propiedad se pasará al
WS_CREATE_CHANNEL_CALLBACK.


Si no se especifica esta propiedad, su valor es NULL y el tamaño es cero.
WS_CHANNEL_PROPERTY_CUSTOM_CHANNEL_INSTANCE
Valor: 26
Un void usado con WsGetChannelProperty para WS_CUSTOM_CHANNEL_BINDING.


El tamaño de la propiedad es sizeof(void).
El valor corresponde al valor de instancia de canal devuelto por
la WS_CREATE_CHANNEL_CALLBACK.


Esta propiedad se puede usar para obtener el canal subyacente.
instancia de para un canal personalizado. Esto permite que un autor de la llamada directamente
interactuar con la instancia de para los casos en los que el objeto existente
El conjunto de propiedades de canal o funciones de canal no es suficiente.
WS_CHANNEL_PROPERTY_TRANSPORT_URL
Valor: 27
Estructura de WS_STRING
se usa con WsGetChannelProperty
para WS_HTTP_CHANNEL_BINDING o WS_TCP_CHANNEL_BINDING para canales creados con WsCreateChannelForListener.


Esta propiedad se usa en el servidor para obtener la dirección URL que se pasó.
a WsOpenChannel en el cliente.
Esta dirección URL puede ser diferente del valor de la WS_TO_HEADER
si se usó WsAddressMessage . Asignación de
dirección URL de transporte al transporte subyacente varía según
WS_CHANNEL_BINDING, como se indica a continuación:



Esta propiedad solo está disponible una vez que el canal tiene
se aceptó mediante WsAcceptChannel.


El autor de la llamada debe pasar la dirección de un WS_STRING cuando
recuperando esta propiedad. La cadena devuelta es una completa
Dirección URL en formato codificado. La cadena devuelta es buena hasta que el canal
se libera o restablece.
WS_CHANNEL_PROPERTY_NO_DELAY
Valor: 28
BoOL usado con WsCreateChannel, WsCreateChannelForListener o WsGetChannelProperty o WsSetChannelProperty para WS_TCP_CHANNEL_BINDING.


Esta propiedad controla el valor de la opción de socket TCP_NODELAY del socket subyacente.


Cuando este valor es FALSE, se usa el algoritmo nagle que puede
mejorar el rendimiento mediante la fusión de mensajes pequeños.


Establecer este valor en TRUE puede disminuir la latencia a costa del rendimiento.
para mensajes pequeños.


El valor predeterminado es FALSE.
WS_CHANNEL_PROPERTY_SEND_KEEP_ALIVES
Valor: 29
BoOL usado con WsCreateChannel, WsCreateChannelForListener para WS_TCP_CHANNEL_BINDING.


Esta propiedad controla el valor de la opción de socket SO_KEEPALIVE del socket subyacente.


Establecer este valor en TRUE hará que se envíen paquetes keep-alive.
en el socket subyacente, que puede ayudar a detectar cuándo
una entidad remota ya no está disponible.


El valor predeterminado es FALSE.
WS_CHANNEL_PROPERTY_KEEP_ALIVE_TIME
Valor: 30
ULONG usado con WsCreateChannel o WsCreateChannelForListener para WS_TCP_CHANNEL_BINDING.


Esta propiedad se mide en milisegundos.


Esta propiedad solo se puede especificar cuando la propiedad WS_CHANNEL_PROPERTY_SEND_KEEP_ALIVES tiene el valor true.


El valor representa la cantidad de tiempo antes de enviar paquetes keep alive si
socket no está en uso.


El valor predeterminado es 2 horas.
WS_CHANNEL_PROPERTY_KEEP_ALIVE_INTERVAL
Valor: 31
ULONG usado con WsCreateChannel o WsCreateChannelForListener para WS_TCP_CHANNEL_BINDING.


Esta propiedad se mide en milisegundos.


Esta propiedad solo se puede especificar cuando la propiedad WS_CHANNEL_PROPERTY_SEND_KEEP_ALIVES tiene el valor true.


Después de que haya expirado la hora especificada en WS_CHANNEL_PROPERTY_KEEP_ALIVE_TIME ,
el sistema comenzará a enviar paquetes activos en un intento de ponerse en contacto
la parte remota. Esta configuración controla la frecuencia con la que el sistema enviará
otro paquete (como intento de reintento).


El valor predeterminado es 1 segundo.
WS_CHANNEL_PROPERTY_MAX_HTTP_SERVER_CONNECTIONS
Valor: 32
ULONG usado con WsCreateChannel para WS_HTTP_CHANNEL_BINDING.


Esta propiedad especifica el número máximo de conexiones que una aplicación cliente
puede tener en un servidor HTTP.
Las conexiones se pueden almacenar en caché y volver a usarse en otros componentes del mismo proceso que acceden al mismo servidor HTTP.


El valor predeterminado es INFINITE (sin límite).
WS_CHANNEL_PROPERTY_IS_SESSION_SHUT_DOWN
Valor: 33
BoOL usado con WsGetChannelProperty para WS_TCP_CHANNEL_BINDING
o WS_NAMEDPIPE_CHANNEL_BINDING con WS_CHANNEL_TYPE_DUPLEX_SESSION.


Esta propiedad indica
si WsShutdownSessionChannel ha sido
se usa para apagar el canal.


El canal debe estar en WS_CHANNEL_STATE_OPEN o
WS_CHANNEL_STATE_FAULTED estado.
WS_CHANNEL_PROPERTY_CHANNEL_TYPE
Valor: 34
Valor de WS_CHANNEL_TYPE
se usa con WsGetChannelProperty para todos los tipos de canal
para consultar el tipo del canal.


El canal puede estar en cualquier WS_CHANNEL_STATE.
WS_CHANNEL_PROPERTY_TRIM_BUFFERED_MESSAGE_SIZE
Valor: 35
ULONG usado con WsCreateChannel, WsCreateChannelForListener o
WsGetChannelProperty para WS_TCP_CHANNEL_BINDING,
WS_HTTP_CHANNEL_BINDING o WS_NAMEDPIPE_CHANNEL_BINDING para controlar la asignación de memoria
características de los mensajes en el canal.


Esta propiedad especifica la cantidad máxima de memoria que mantendrá el canal.
alrededor de después de restablecer un mensaje. Si todo
los mensajes que ve un canal son todos más pequeños que este tamaño y, a continuación, las asignaciones
con el fin de almacenar en búfer los mensajes se minimizarán.


Esta propiedad solo se puede especificar cuando se ha almacenado en búfer la entrada o la salida
especificado ( ya sea WS_STREAMED_INPUT_TRANSFER_MODE o
WS_STREAMED_OUTPUT_TRANSFER_MODE no se han establecido).


El valor predeterminado es 65536.


El WS_UDP_CHANNEL_BINDING siempre usa el valor 65536.
WS_CHANNEL_PROPERTY_ENCODER
Valor: 36
Estructura WS_CHANNEL_ENCODER usada con WsCreateChannel o WsCreateChannelForListener para WS_TCP_CHANNEL_BINDING,
WS_HTTP_CHANNEL_BINDING o WS_NAMEDPIPE_CHANNEL_BINDING para proporcionar una codificación personalizada de mensajes.

Esta propiedad no se puede usar con WS_UDP_CHANNEL_BINDING.
WS_CHANNEL_PROPERTY_DECODER
Valor: 37
Estructura WS_CHANNEL_DECODER usada con WsCreateChannel o WsCreateChannelForListener para WS_TCP_CHANNEL_BINDING,
WS_HTTP_CHANNEL_BINDING o WS_NAMEDPIPE_CHANNEL_BINDING para proporcionar una descodificación personalizada de mensajes.

Esta propiedad no se puede usar con WS_UDP_CHANNEL_BINDING.
WS_CHANNEL_PROPERTY_PROTECTION_LEVEL
Valor: 38
Valor WS_PROTECTION_LEVEL usado con WsGetChannelProperty para cualquier tipo de canal.


Esta propiedad indica
las garantías de seguridad proporcionadas por el canal.


El valor de esta propiedad depende de los requisitos de seguridad.
solicitado para el canal.
WS_CHANNEL_PROPERTY_COOKIE_MODE
Valor: 39
Valor de WS_COOKIE_MODE usado con WsCreateChannel con WS_HTTP_CHANNEL_BINDING para controlar cómo se controlan las cookies HTTP.


El valor predeterminado es WS_AUTO_COOKIE_MODE.
WS_CHANNEL_PROPERTY_HTTP_PROXY_SETTING_MODE
Valor: 40
Valor de WS_HTTP_PROXY_SETTING_MODE usado con WsCreateChannel con WS_HTTP_CHANNEL_BINDING para controlar la configuración del proxy HTTP para el canal.


El valor predeterminado es WS_HTTP_PROXY_SETTING_MODE_AUTO.
WS_CHANNEL_PROPERTY_CUSTOM_HTTP_PROXY
Valor: 41
Estructura de WS_CUSTOM_HTTP_PROXY usada con WsCreateChannel con WS_HTTP_CHANNEL_BINDING para especificar la configuración personalizada personalizada para el canal HTTP. Esta propiedad debe
se especifica cuando se establece WS_CHANNEL_PROPERTY_HTTP_PROXY_SETTING_MODE en
WS_HTTP_PROXY_SETTING_MODE_CUSTOM.


El valor predeterminado es NULL.
WS_CHANNEL_PROPERTY_HTTP_MESSAGE_MAPPING
Valor: 42
Estructura de WS_HTTP_MESSAGE_MAPPING usada con WsCreateChannel o WsCreateChannelForListener para WS_HTTP_CHANNEL_BINDING.


Este valor de propiedad controla cómo se asigna una solicitud o respuesta HTTP a
un objeto message. Consulte WS_HTTP_MESSAGE_MAPPING para obtener más información.


El valor predeterminado de esta propiedad es una estructura WS_HTTP_MESSAGE_MAPPING es la siguiente:



  • requestMappingOptions: 0

  • requestHeaderMappings: none

  • responseMappingOptions: 0

  • responseHeaderMappings: none



WS_HTTP_MESSAGE_MAPPING campos requestMappingOptions y responseMappingOptions deben ser 0
a menos que la codificación esté establecida en WS_ENCODING_RAW mediante la propiedad channel WS_CHANNEL_PROPERTY_ENCODING.
WS_CHANNEL_PROPERTY_ENABLE_HTTP_REDIRECT
Valor: 43
BoOL usado con WsCreateChannel para WS_HTTP_CHANNEL_BINDING con WS_CHANNEL_TYPE_REQUEST.


Este valor de propiedad controla si está habilitado el redireccionamiento automático HTTP.


Si se establece este valor en TRUE , se habilita el redireccionamiento automático HTTP.


El valor predeterminado es FALSE.
Si se especifica la propiedad WS_CHANNEL_PROPERTY_HTTP_REDIRECT_CALLBACK_CONTEXT ,
esta propiedad se omite.
WS_CHANNEL_PROPERTY_HTTP_REDIRECT_CALLBACK_CONTEXT
Valor: 44
Estructura de WS_HTTP_REDIRECT_CALLBACK_CONTEXT
se usa con WsCreateChannel para WS_HTTP_CHANNEL_BINDING con WS_CHANNEL_TYPE_REQUEST.


Este valor de propiedad se puede especificar cuando se necesita un control más granular de la redirección HTTP automática.


Cuando se establece esta propiedad, se llamará a la rutina de devolución de llamada especificada con la dirección URL del punto de conexión original.
y la nueva dirección URL a la que se reenvía el mensaje. El valor devuelto de devolución de llamada se usa para indicar si
se debe permitir el redireccionamiento.
WS_CHANNEL_PROPERTY_FAULTS_AS_ERRORS
Valor: 45
BoOL usado con WsCreateChannel, WsSetChannelProperty,
WsGetChannelProperty o WsCreateServiceProxy para WS_HTTP_CHANNEL_BINDING y WS_CHANNEL_TYPE_REQUEST, o WS_TCP_CHANNEL_BINDING, WS_NAMEDPIPE_CHANNEL_BINDING y WS_UDP_CHANNEL_BINDING en el cliente.


Cuando se establece en TRUE, las funciones Channel y Service Model devuelven un código de error cuando se recibe un error.
Si este tiempo de ejecución reconoce el error, se devuelve el código de error correspondiente,
de lo contrario , se devuelve WS_E_ENDPOINT_FAULT_RECEIVED . (Consulte Valores devueltos de servicios web de Windows). Cuando se establece en FALSE, WsReceiveMessage
y WsRequestReplydevuelven WS_E_ENDPOINT_FAULT_RECEIVED cuando se recibe un error.
Las demás funciones de canal devuelven errores como mensajes normales y'WS_MESSAGE_PROPERTY_IS_FAULT
se puede usar para distinguir los errores de otros mensajes.


Cuando esta propiedad se establece en TRUE y se usa con WsCreateChannel o WsSetChannelProperty,
invalida el siguiente comportamiento de WS_CHANNEL_PROPERTY_ALLOW_UNSECURED_FAULTS: si el error lo reconoce .
runtime, un error no seguro no hará que se produzca un error en la comprobación de seguridad del mensaje de error, incluso si
WS_CHANNEL_PROPERTY_ALLOW_UNSECURED_FAULTS se establece en FALSE. El estado de la comprobación de seguridad
se puede determinar inspeccionando WS_MESSAGE_PROPERTY_PROTECTION_LEVEL.
Esto no se aplica a WS_UDP_CHANNEL_BINDING , ya que no admite la seguridad.


Cuando esta propiedad se establece en FALSE o se usa con WsCreateServiceProxy o no se reconoce el error.
por el tiempo de ejecución, el comportamiento descrito en WS_CHANNEL_PROPERTY_ALLOW_UNSECURED_FAULTS se aplica sin
.


Independientemente de este valor de propiedad, si se devuelve un código de error como resultado de recibir un error,
WsGetFaultErrorProperty se puede usar para consultar los detalles del error del objeto de error.


Esta propiedad se puede establecer en cualquier estado de canal.


El valor predeterminado es TRUE. Si se usa con WsCreateServiceProxy, esta propiedad debe establecerse en TRUE.




Establecer esta propiedad en TRUE puede hacer que la comprobación de seguridad del mensaje se deshabilite para determinados errores.
Es posible que los errores no comprobados no sean de confianza.
WS_CHANNEL_PROPERTY_ALLOW_UNSECURED_FAULTS
Valor: 46
Un BOOL usado con WsCreateChannel, WsSetChannelProperty,
o WsGetChannelProperty para WS_HTTP_CHANNEL_BINDING y WS_CHANNEL_TYPE_REQUEST, o WS_TCP_CHANNEL_BINDING y WS_NAMEDPIPE_CHANNEL_BINDING en el cliente.


Cuando se establece en TRUE, los errores no seguros recibidos en un canal seguro no provocan un error en la comprobación de seguridad del mensaje. En su lugar,
el error se tratará como si la comprobación de seguridad del mensaje se realizara correctamente y se controlara como se describe en WS_CHANNEL_PROPERTY_FAULTS_AS_ERRORS.
El estado de la comprobación de seguridad se puede determinar inspeccionando WS_MESSAGE_PROPERTY_PROTECTION_LEVEL.


Cuando se establece en FALSE, la comprobación de seguridad del mensaje de los mensajes de error se controla como la comprobación de cualquier otro mensaje.


WS_CHANNEL_PROPERTY_FAULTS_AS_ERRORS puede invalidar esta propiedad para los errores reconocidos por este tiempo de ejecución.


Esta propiedad solo se aplica a la comprobación de seguridad de nivel de mensaje y no tiene ningún impacto en la seguridad de transporte.


Esta propiedad se puede establecer en cualquier estado de canal.


El valor predeterminado es FALSE.


Establecer esta propiedad en TRUE hace que se deshabilite la comprobación de seguridad del mensaje para los errores. Es posible que los errores no seguros no sean de confianza.
WS_CHANNEL_PROPERTY_HTTP_SERVER_SPN
Valor: 47
Un puntero WCHAR
se usa con WsGetChannelProperty para WS_HTTP_CHANNEL_BINDING y WS_CHANNEL_TYPE_REQUEST.



Devuelve el nombre principal del servidor del punto de conexión remoto usado para la última solicitud con error. No hay ninguna garantía de que esta propiedad sea
disponibles. A continuación se muestran las condiciones necesarias (pero no siempre suficientes) para que esta propiedad esté presente:

  • El canal envió una solicitud.

  • No se pudo realizar la solicitud debido a esquemas de autenticación de encabezado HTTP que no coinciden. Consulte WS_HTTP_HEADER_AUTH_SECURITY_BINDING.

  • El punto de conexión remoto admite el esquema de autenticación "Nego2".




Esta propiedad solo está disponible en Windows 7 y versiones posteriores.
WS_CHANNEL_PROPERTY_HTTP_PROXY_SPN
Valor: 48
Puntero WCHAR usado con WsGetChannelProperty para WS_HTTP_CHANNEL_BINDING y WS_CHANNEL_TYPE_REQUEST.



Devuelve el nombre principal del servidor del servidor proxy HTTP usado para la última solicitud con error. No hay ninguna garantía de que esta propiedad sea
disponibles. A continuación se muestran las condiciones necesarias (pero no siempre suficientes) para que esta propiedad esté presente:

  • El canal envió una solicitud.

  • No se pudo realizar la solicitud debido a esquemas de autenticación de encabezado HTTP que no coinciden. Consulte WS_HTTP_HEADER_AUTH_SECURITY_BINDING.

  • El servidor proxy HTTP admite el esquema de autenticación "Nego2".




Esta propiedad solo está disponible en Windows 7 y versiones posteriores.
WS_CHANNEL_PROPERTY_MAX_HTTP_REQUEST_HEADERS_BUFFER_SIZE
Valor: 49
ULONG usado con WsCreateChannelForListener o
WsGetChannelProperty para WS_HTTP_CHANNEL_BINDING
con WS_CHANNEL_TYPE_REPLY. Este valor es un límite en cuanto al tamaño de los encabezados
de una solicitud HTTP que se recibe puede ser. El límite especifica el tamaño máximo.
de los encabezados de solicitud HTTP en bytes.


Esta propiedad limita la cantidad de memoria.
que el WS_HTTP_CHANNEL_BINDING con WS_CHANNEL_TYPE_REPLY
asignará para recibir encabezados de solicitud HTTP. Al recibir, toda la solicitud HTTP
Los encabezados se leen en un búfer antes del procesamiento.


El valor predeterminado es 65536.

Requisitos

   
Cliente mínimo compatible Windows 7 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2008 R2 [aplicaciones de escritorio | Aplicaciones para UWP]
Encabezado webservices.h