Control de versiones (API de servidor HTTP)

La API del servidor HTTP versión 2.0 deja obsoletas las colas de solicitudes de la versión 1.0 y las asociaciones de direcciones URL con la cola de solicitudes. El control de versiones con ámbito de objeto permite a las aplicaciones proporcionar información de versión específica de la aplicación. Las aplicaciones pueden llamar automáticamente a la versión correcta de las estructuras para el sistema operativo en el que se ejecuta.

Colas de solicitudes

A partir de la API de HTTP Server versión 2.0, las colas de solicitudes se crean con HttpCreateRequestQueue , lo que hace obsoleto la función HttpCreateHttpHandle de la versión 1.0. Los grupos de direcciones URL se presentan en la versión 2.0 con la función HttpCreateUrlGroup . Las direcciones URL se agregan al grupo mediante HttpAddUrlToUrlGroup , lo que hace obsoleto la función HttpAddUrl de la versión 1.0. Los grupos de direcciones URL de la versión 2.0 no se deben usar con las colas de solicitudes de la versión 1.0.

A partir de la versión 2.0, las siguientes funciones de la versión 1.0 están obsoletas y no se pueden usar con las colas de solicitudes de la versión 2.0:

Para obtener más información sobre cómo configurar grupos de direcciones URL, consulte el tema Configuring the URL Group (Configuración del grupo de direcciones URL). Para obtener más información sobre las colas de solicitudes de la versión 2.0, consulte el tema Cola de solicitudes con nombre.

Control de versiones de Object-Scoped

En la versión 1.0, la aplicación proporciona la versión de la API del servidor HTTP en la llamada a HttpInitialize. La información de versión solo se acepta desde la primera aplicación que llamó a HttpInitialize y se aplica a todas las aplicaciones de API de servidor HTTP en el mismo proceso. A partir de la API de la versión 2.0, no se usa la información de versión global proporcionada en la llamada a HttpInitialize . Para las aplicaciones de la versión 2.0, la versión de la API del servidor HTTP se pasa en el parámetro Version cuando HttpCreateRequestQueue o HttpCreateServerSession crea la sesión de la cola de solicitudes o el servidor. Cuando se crea la cola de solicitudes con la versión 1.0 HttpCreateHttpHandle, se marca automáticamente como versión 1.0. Las aplicaciones de la versión 1.0 y 2.0 se pueden ejecutar en el mismo proceso.

Las estructuras de HTTP_REQUEST y HTTP_RESPONSE se actualizan para incluir información de autenticación en la API http Server versión 2.0. HTTP_REQUEST_V1 y HTTP_REQUEST_V2 son específicos de la versión de la API usada por la aplicación. Sin embargo, las aplicaciones no deben usar estas estructuras directamente en su código; en su lugar, deben usar HTTP_REQUEST para obtener la versión correcta en función de la versión de la cola de solicitudes en la que se recibió la solicitud. Además, tenga en cuenta que el tamaño de la estructura de HTTP_REQUEST se basa en la versión del sistema operativo en el que se compila el código.