enumeración WS_CHANNEL_PROPERTY_ID (webservices.h)
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_SIZEValor: 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_SIZEValor: 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_SIZEValor: 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_SIZEValor: 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_ENCODINGValor: 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_VERSIONValor: 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_VERSIONValor: 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_SIZEValor: 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_STATEValor: 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_MODELValor: 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_VERSIONValor: 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_TIMEOUTValor: 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_TIMEOUTValor: 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_TIMEOUTValor: 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_TIMEOUTValor: 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_TIMEOUTValor: 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_TIMEOUTValor: 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_TIMEOUTSValor: 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_MODEValor: 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_INTERFACEValor: 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_HOPSValor: 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_ADDRESSValor: 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_ADDRESSValor: 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_IDValor: 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_CALLBACKSValor: 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_PARAMETERSValor: 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_INSTANCEValor: 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_URLValor: 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_DELAYValor: 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_ALIVESValor: 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_TIMEValor: 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_INTERVALValor: 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_CONNECTIONSValor: 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_DOWNValor: 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_TYPEValor: 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_SIZEValor: 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_ENCODERValor: 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_DECODERValor: 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_LEVELValor: 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_MODEValor: 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_MODEValor: 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_PROXYValor: 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_MAPPINGValor: 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:
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_REDIRECTValor: 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_CONTEXTValor: 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_ERRORSValor: 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_FAULTSValor: 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_SPNValor: 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:
Esta propiedad solo está disponible en Windows 7 y versiones posteriores. |
WS_CHANNEL_PROPERTY_HTTP_PROXY_SPNValor: 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:
Esta propiedad solo está disponible en Windows 7 y versiones posteriores. |
WS_CHANNEL_PROPERTY_MAX_HTTP_REQUEST_HEADERS_BUFFER_SIZEValor: 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 |
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de