Función HttpCreateHttpHandle (http.h)

La función HttpCreateHttpHandle crea una cola de solicitudes HTTP para la aplicación que realiza la llamada y devuelve un identificador.

A partir de http Server API versión 2.0, las aplicaciones deben llamar a HttpCreateRequestQueue para crear la cola de solicitudes; No se debe usar HttpCreateHttpHandle .

Sintaxis

HTTPAPI_LINKAGE ULONG HttpCreateHttpHandle(
  [out] PHANDLE RequestQueueHandle,
  [in]  ULONG   Reserved
);

Parámetros

[out] RequestQueueHandle

Puntero a una variable que recibe un identificador de la cola de solicitudes.

[in] Reserved

Reservado. Este parámetro debe ser cero.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es NO_ERROR.

Si se produce un error en la función, el valor devuelto es uno de los siguientes códigos de error.

Comentarios

La cola de solicitudes permite que la aplicación que realiza la llamada reciba solicitudes para direcciones URL concretas. La aplicación que realiza la llamada usa la función HttpAddUrl para especificar la dirección URL para la que debe recibir solicitudes.

Una aplicación debe usar una sola cola de solicitudes para recibir solicitudes. El uso de varias colas de solicitudes desde un único proceso no aumenta el tiempo de respuesta ni el rendimiento.

Cuando una aplicación haya terminado de recibir solicitudes, debe llamar a la función CloseHandle para cerrar el identificador.

Requisitos

Consulte también

Funciones de la API de servidor HTTP versión 1.0

HttpAddUrl

HttpCreateRequestQueue