Compartir a través de

enumeración WS_SERVICE_ENDPOINT_PROPERTY_ID (webservices.h)

  • Artículo

Cada propiedad representa parámetros opcionales para configurar la estructura de WS_SERVICE_ENDPOINT especificada. Esta enumeración se usa dentro de la estructura WS_SERVICE_ENDPOINT_PROPERTY que forma parte de WS_SERVICE_ENDPOINT.

Syntax

typedef enum {
  WS_SERVICE_ENDPOINT_PROPERTY_ACCEPT_CHANNEL_CALLBACK = 0,
  WS_SERVICE_ENDPOINT_PROPERTY_CLOSE_CHANNEL_CALLBACK = 1,
  WS_SERVICE_ENDPOINT_PROPERTY_MAX_ACCEPTING_CHANNELS = 2,
  WS_SERVICE_ENDPOINT_PROPERTY_MAX_CONCURRENCY = 3,
  WS_SERVICE_ENDPOINT_PROPERTY_BODY_HEAP_MAX_SIZE = 4,
  WS_SERVICE_ENDPOINT_PROPERTY_BODY_HEAP_TRIM_SIZE = 5,
  WS_SERVICE_ENDPOINT_PROPERTY_MESSAGE_PROPERTIES = 6,
  WS_SERVICE_ENDPOINT_PROPERTY_MAX_CALL_POOL_SIZE = 7,
  WS_SERVICE_ENDPOINT_PROPERTY_MAX_CHANNEL_POOL_SIZE = 8,
  WS_SERVICE_ENDPOINT_PROPERTY_LISTENER_PROPERTIES = 9,
  WS_SERVICE_ENDPOINT_PROPERTY_CHECK_MUST_UNDERSTAND = 10,
  WS_SERVICE_ENDPOINT_PROPERTY_METADATA_EXCHANGE_TYPE = 11,
  WS_SERVICE_ENDPOINT_PROPERTY_METADATA = 12,
  WS_SERVICE_ENDPOINT_PROPERTY_METADATA_EXCHANGE_URL_SUFFIX = 13,
  WS_SERVICE_ENDPOINT_PROPERTY_MAX_CHANNELS = 14
} WS_SERVICE_ENDPOINT_PROPERTY_ID;

Constantes

 
WS_SERVICE_ENDPOINT_PROPERTY_ACCEPT_CHANNEL_CALLBACK
Valor: 0
Se usa con WS_SERVICE_ENDPOINT.
El valor es un puntero a WS_SERVICE_PROPERTY_ACCEPT_CALLBACK estructura.
WS_SERVICE_ENDPOINT_PROPERTY_CLOSE_CHANNEL_CALLBACK
Valor: 1
Se usa con WS_SERVICE_ENDPOINT.
El valor es un puntero a WS_SERVICE_PROPERTY_CLOSE_CALLBACK estructura.
WS_SERVICE_ENDPOINT_PROPERTY_MAX_ACCEPTING_CHANNELS
Valor: 2
Se usa con WS_SERVICE_ENDPOINT, especifica el número máximo de hosts de servicio de canales simultáneos.
aceptar activamente nuevas conexiones para un punto de conexión determinado. Cuando no se especifica este valor se establece en 1. Si un punto de conexión especifica un controlador de mensajes predeterminado (consulte WS_SERVICE_ENDPOINT) simultaneidad
tiene que ser 1.
WS_SERVICE_ENDPOINT_PROPERTY_MAX_CONCURRENCY
Valor: 3
Se usa con WS_SERVICE_ENDPOINT, especifica el número máximo de llamadas simultáneas que se atenderían en un canal basado en sesión.
Cuando no se especifica este valor se establece en 1. Si un punto de conexión especifica un controlador de mensajes predeterminado (consulte WS_SERVICE_ENDPOINT simultaneidad
tiene que ser 1.
WS_SERVICE_ENDPOINT_PROPERTY_BODY_HEAP_MAX_SIZE
Valor: 4
Tamaño máximo del montón para la deserialización del cuerpo.


Esta es la configuración disponible del montón que se usa para deserializar el cuerpo. Este montón también es
disponible para las operaciones de servicio para asignar parámetros de salida.


El valor predeterminado es 65535 bytes.
WS_SERVICE_ENDPOINT_PROPERTY_BODY_HEAP_TRIM_SIZE
Valor: 5
Tamaño de recorte del montón para la deserialización del cuerpo.


Esta es la configuración disponible del montón que se usa para deserializar el cuerpo. Este montón también es
disponible para las operaciones de servicio para asignar parámetros de salida.


El valor predeterminado es 4096 bytes.
WS_SERVICE_ENDPOINT_PROPERTY_MESSAGE_PROPERTIES
Valor: 6
Esta propiedad permite al usuario especificar las propiedades del mensaje.
objetos usados por el punto de conexión para enviar y recibir mensajes.


Esta propiedad se puede especificar cuando se crea el host de servicio.


El valor especificado debe ser de tipo WS_MESSAGE_PROPERTIES.


Se pueden especificar las siguientes propiedades de mensaje:
WS_SERVICE_ENDPOINT_PROPERTY_MAX_CALL_POOL_SIZE
Valor: 7
Número máximo de objetos de mantenimiento de llamadas que se agruparían para atender un objeto de mensaje, en un determinado
Extremo. Tenga en cuenta que, en el caso de los canales basados en sesiones, se pueden usar muchos objetos de llamada en un solo
canal si WS_SERVICE_ENDPOINT_PROPERTY_MAX_CONCURRENCY es mayor que 1.


Para los canales sin sesión, esta propiedad debe ser idealmente igual a WS_SERVICE_ENDPOINT_PROPERTY_MAX_CHANNEL_POOL_SIZE.


El valor predeterminado es 100.
WS_SERVICE_ENDPOINT_PROPERTY_MAX_CHANNEL_POOL_SIZE
Valor: 8
Número máximo de WS_CHANNEL agrupados por el host de servicio en un determinado
Extremo.


El valor predeterminado es 100.
WS_SERVICE_ENDPOINT_PROPERTY_LISTENER_PROPERTIES
Valor: 9
Propiedades del agente de escucha.
WS_SERVICE_ENDPOINT_PROPERTY_CHECK_MUST_UNDERSTAND
Valor: 10
Las habilitaciones o deshabilitaciones deben comprender la comprobación de encabezados en un punto de conexión. Esto es "TRUE" de forma predeterminada.
WS_SERVICE_ENDPOINT_PROPERTY_METADATA_EXCHANGE_TYPE
Valor: 11
Esta propiedad se puede establecer en WS_METADATA_EXCHANGE_TYPE_MEX para habilitar
mantenimiento de WS-MetadataExchange solicitudes en el punto de conexión. En caso de que la aplicación desee
exponer metadatos a través de HTTP GET, esta propiedad se puede establecer en WS_METADATA_EXCHANGE_TYPE_HTTP_GET

Si no se especifica, el valor predeterminado de esta propiedad es "WS_METADATA_EXCHANGE_TYPE_NONE".


Tenga en cuenta que esta propiedad cuando se establece en WS_METADATA_EXCHANGE_TYPE_HTTP_GET cambia la propiedad WS_LISTENER
WS_LISTENER_PROPERTY_TRANSPORT_URL_MATCHING_OPTIONS y
WS_LISTENER_PROPERTY_TO_HEADER_MATCHING_OPTIONS a WS_MATCH_URL_PREFIX_PATH.


Al establecer esta propiedad en WS_METADATA_EXCHANGE_TYPE_HTTP_GET una aplicación no debe especificar WS_MATCH_URL_EXACT_PATH para el agente de escucha.
propiedades WS_LISTENER_PROPERTY_TRANSPORT_URL_MATCHING_OPTIONS y WS_LISTENER_PROPERTY_TO_HEADER_MATCHING_OPTIONS para el WS_SERVICE_ENDPOINT especificado.
WS_SERVICE_ENDPOINT_PROPERTY_METADATA
Valor: 12
Especifica el nombre del puerto WSDL, el nombre de enlace y el espacio de nombres de enlace para el punto de conexión.


Esta propiedad debe especificarse para habilitar la participación del WS_SERVICE_ENDPOINT en WS-Metadata Exchange.


Consulte WS_SERVICE_ENDPOINT_METADATA para obtener más detalles.
WS_SERVICE_ENDPOINT_PROPERTY_METADATA_EXCHANGE_URL_SUFFIX
Valor: 13
Especifica el sufijo que se concatena tal cual en la dirección URL de WS_SERVICE_ENDPOINT para generar una dirección URL para WS-MetadataExchange servicio de solicitudes v1.1.
La dirección URL generada se usa para comparar con el encabezado "to" del mensaje recibido. Tenga en cuenta que si el mensaje no contiene un encabezado "to", las solicitudes no son
Serviced.


Esta propiedad solo debe especificarse si WS_SERVICE_ENDPOINT_PROPERTY_METADATA_EXCHANGE_TYPE se establece en WS_METADATA_EXCHANGE_TYPE_MEX.


Especificar esta propiedad es útil en los casos en los que una aplicación desea controlar WS-Transfer obtener solicitudes, así como usar el mismo punto de conexión para atender
WS-MetadataExchange solicitudes v1.1. La dirección URL de generación en este caso se usa para filtrar WS-Transfer Obtener solicitudes de Ws-MetadataExchange v1.1.


De forma predeterminada, no se realiza ningún filtrado para WS-MetadataExchange v1.1 para MEX y el punto de conexión controlará todas las solicitudes GET de WS-Transfer para Ws-MetadataExchange v1.1, si
Ws-MetadataExchange v1.1 está habilitado en el punto de conexión.


Tenga en cuenta que esta propiedad cambia el WS_LISTENER_PROPERTY_TRANSPORT_URL_MATCHING_OPTIONS de la propiedad WS_LISTENER y
WS_LISTENER_PROPERTY_TO_HEADER_MATCHING_OPTIONS a WS_MATCH_URL_PREFIX_PATH.


Al establecer esta propiedad, una aplicación no debe especificar WS_MATCH_URL_EXACT_PATH para el agente de escucha.
propiedades WS_LISTENER_PROPERTY_TRANSPORT_URL_MATCHING_OPTIONS y WS_LISTENER_PROPERTY_TO_HEADER_MATCHING_OPTIONS
para el WS_SERVICE_ENDPOINT especificado.
WS_SERVICE_ENDPOINT_PROPERTY_MAX_CHANNELS
Valor: 14
Número máximo de canales que se pueden atender en el punto de conexión.


El valor predeterminado es 100.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 R2 [solo aplicaciones de escritorio]
Encabezado webservices.h