Configurar propiedades
La API del servidor HTTP versión 2.0 permite a las aplicaciones configurar manualmente colas de solicitudes, sesiones de servidor y grupos de direcciones URL. La sesión del servidor es el objeto de nivel superior que contiene información de configuración que se aplica a todos los grupos de direcciones URL creados en ellos. La aplicación crea una sesión de servidor con uno o varios grupos de direcciones URL en ella y, a continuación, asocia el grupo de direcciones URL a una cola de solicitudes.
Para obtener más información sobre objetos de configuración específicos en la API de HTTP Server versión 2.0, consulte:
- Configuración de la sesión del servidor
- Configuración del grupo de direcciones URL
- Configuración de los temporizadores anchos de API de SERVIDOR HTTP
Las propiedades de los objetos de configuración se establecen con HttpSetServerSessionProperty, HttpSetUrlGroupProperty y HttpSetRequestQueueProperty como se muestra en el diagrama siguiente. La asociación entre la cola de solicitudes y el grupo de direcciones URL se puede cambiar a petición, mientras que no se puede cambiar la asociación entre la sesión del servidor y los grupos de direcciones URL. Los grupos de direcciones URL deben estar asociados a una cola de solicitudes para recibir solicitudes.
En la tabla siguiente se enumeran las propiedades que se pueden establecer en cada objeto de configuración. En general, si la aplicación establece ninguna configuración de propiedad, se aplican las configuraciones predeterminadas de la API del servidor HTTP. Las propiedades de configuración establecidas por la aplicación en la sesión del servidor reemplazan las configuraciones para toda la API del servidor HTTP. Las configuraciones establecidas en el grupo de direcciones URL invalidan las configuraciones de sesión del servidor y las configuraciones de cola de solicitudes invalidan las configuraciones predeterminadas de la API del servidor HTTP.
Objeto Configuration | Propiedad |
---|---|
Sesión del servidor | HttpServerStateProperty HttpServerLoggingProperty HttpServerQosProperty HttpServerTimeoutsProperty HttpServerAuthenticationProperty |
Grupo de direcciones URL | HttpServerStateProperty HttpServerAuthenticationProperty HttpServerLoggingProperty HttpServerQosProperty HttpServerBindingProperty HttpServerTimeoutsProperty |
Cola de solicitudes | HttpServerStateProperty HttpServerQueueLengthProperty HttpServer503VerbosityProperty |
Las propiedades de sesión del servidor se definen en la enumeración HTTP_SERVER_PROPERTY . En la tabla siguiente se enumeran las estructuras de propiedad que se establecen para cada tipo de propiedad y la API del servidor HTTP predeterminada cuando la aplicación no establece estas propiedades.
Propiedad | Estructura | Valor predeterminado de la API del servidor HTTP |
---|---|---|
HttpServerAuthenticatonProperty | HTTP_SERVER_AUTHENTICATION_INFO | Sin autenticación |
HttpServerLoggingProperty | HTTP_LOGGING_INFO | Sin registro |
HttpServerQosProperty-HttpQosSettingTypeConnectionLimit> | HTTP_CONNECTION_LIMIT_INFO | Ilimitado |
HttpServerTimeoutsProperty | HTTP_TIMEOUT_LIMIT_INFO | 120 s. |
HttpServerQosProperty-HttpQosSettingTypeBandwidth> | HTTP_BANDWIDTH_LIMIT_INFO | Ilimitado |
HttpServerQueueLengthProperty | ULONG | 1000 |
HttpServerStateProperty | HTTP_STATE_INFO | habilitado |
HttpServer503VerbosityProperty | HTTP_503_RESPONSE_VERBOSITY | HttpResponseVerbosityBasic |
HttpServerBindingProperty | HTTP_BINDING_INFO | None |
En la tabla siguiente se enumeran los valores mínimo y máximo para las configuraciones de la API de servidor HTTP.
Propiedad | HTTP Server API Maximum and Minimum |
---|---|
HttpServerQosProperty-HttpQosSettingTypeBandwidth> | Min = MIN_ALLOWED_BANDWIDTH_THROTTLING_RATE Max = none |
HttpServerQueueLengthProperty | Min = 0xA Max = 0xFFFF |