estructura HTTP_TIMEOUT_LIMIT_INFO (http.h)

Artículo
02/27/2024

La estructura HTTP_TIMEOUT_LIMIT_INFO define los límites de tiempo de espera de conexión específicos de la aplicación.

Esta estructura se debe usar al establecer o consultar HttpServerTimeoutsProperty en una cola de grupo de direcciones URL, sesión de servidor o solicitud.

Sintaxis

typedef struct _HTTP_TIMEOUT_LIMIT_INFO {
  HTTP_PROPERTY_FLAGS Flags;
  USHORT              EntityBody;
  USHORT              DrainEntityBody;
  USHORT              RequestQueue;
  USHORT              IdleConnection;
  USHORT              HeaderWait;
  ULONG               MinSendRate;
} HTTP_TIMEOUT_LIMIT_INFO, *PHTTP_TIMEOUT_LIMIT_INFO;

Miembros

Flags

Estructura HTTP_PROPERTY_FLAGS que especifica si la propiedad está presente.

EntityBody

El tiempo, en segundos, permitido para que llegue el cuerpo de la entidad de solicitud.

La API del servidor HTTP activa este temporizador cuando la solicitud tiene un cuerpo de entidad. La expiración del temporizador se establece inicialmente en el valor configurado. Cuando la API del servidor HTTP recibe indicaciones de datos adicionales en la solicitud, restablece el temporizador para dar a la conexión otro intervalo.

DrainEntityBody

El tiempo, en segundos, permitido para que la API del servidor HTTP agote el cuerpo de la entidad en una conexión Keep-Alive.

En una conexión de Keep-Alive, después de que la aplicación haya enviado una respuesta para una solicitud y antes de que el cuerpo de la entidad de la solicitud haya llegado por completo, la API del servidor HTTP comienza a purgar el resto del cuerpo de la entidad para llegar a otra solicitud potencialmente canalización del cliente. Si el tiempo para purgar el cuerpo de la entidad restante supera el período permitido, se agota el tiempo de espera de la conexión.

RequestQueue

El tiempo, en segundos, permitido para que la solicitud permanezca en la cola de solicitudes antes de que la aplicación la recoja.

IdleConnection

El tiempo, en segundos, permitido para una conexión inactiva.

Este tiempo de espera solo se aplica después de que la primera solicitud de la conexión se enrute a la aplicación. Para obtener más información, vea la sección Comentarios.

HeaderWait

El tiempo, en segundos, permitido para que la API del servidor HTTP analice el encabezado de solicitud.

Este tiempo de espera solo se aplica después de que la primera solicitud de la conexión se enrute a la aplicación. Para obtener más información, vea la sección Comentarios.

MinSendRate

La velocidad mínima que se envía, en bytes por segundo, para la respuesta. La velocidad de envío de respuesta predeterminada es de 150 bytes por segundo.

Para deshabilitar este temporizador, establezca MinSendRate en MAXULONG.

Comentarios

Esta estructura se usa en las funciones HttpQueryServerSessionProperty y HttpSetServerSessionProperty para establecer o consultar los tiempos de espera de conexión. En la tabla siguiente se enumeran los tiempos de espera predeterminados.

Temporizador	Valor predeterminado de la API del servidor HTTP	Configuración en toda la API del servidor HTTP	Configuración específica de la aplicación
EntityBody	2 minutos	No	Sí
DrainEntityBody	2 minutos	No	Sí
RequestQueue	2 minutos	No	Sí
IdleConnection	2 minutos	Sí	Limitado
HeaderWait	2 minutos	Sí	Limitado
MinSendRate	150 bytes/segundo	No	Sí

Llamar a HttpSetServerSessionProperty o HttpSetUrlGroupProperty para configurar un tiempo de espera de conexión afecta solo a la aplicación que realiza la llamada y no establece límites de tiempo de espera de todo el controlador. Los temporizadores de espera de encabezado y conexión inactiva se pueden configurar para todas las aplicaciones HTTP mediante una llamada a HttpSetServiceConfiguration. Se requieren privilegios administrativos para configurar tiempos de espera amplios de la API de HTTP Server. Las configuraciones en toda la API del servidor HTTP afectan a todas las aplicaciones HTTP del equipo y se conservan cuando se apaga el equipo.

Los temporizadores IdleConnection y HeaderWait específicos de la aplicación se establecen de forma limitada. La API del servidor HTTP no puede determinar la cola de solicitudes o el grupo de direcciones URL a los que está asociada la solicitud hasta que se hayan analizado los encabezados. Por lo tanto, la API del servidor HTTP aplica los temporizadores IdleConnection y HeaderWait predeterminados para la primera solicitud en una conexión. Las solicitudes posteriores en una conexión de Keep-Alive usarán los tiempos de espera específicos de la aplicación.

Establecer un tiempo de espera en una sesión de servidor afecta a todos los grupos de direcciones URL de la sesión del servidor. Sin embargo, si el grupo de direcciones URL ha configurado un tiempo de espera, el valor del grupo de direcciones URL tiene prioridad sobre la configuración de la sesión del servidor.

Establecer un tiempo de espera en cero en una sesión de servidor hace que la API del servidor HTTP revierta al valor predeterminado de ese temporizador. En el caso de los temporizadores establecidos en un grupo de direcciones URL, se usa el tiempo de espera de la sesión del servidor si está presente; de lo contrario, se usa el valor predeterminado de la API del servidor HTTP.

Requisitos

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