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.

Valor	Significado
ERROR_DLL_INIT_FAILED	La aplicación que realiza la llamada no llamó a HttpInitialize antes de llamar a esta función.
Otros	Código de error del sistema definido en WinError.h.

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

Cliente mínimo compatible	Windows Vista, Windows XP con SP2 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	http.h
Library	Httpapi.lib
Archivo DLL	Httpapi.dll

Consulte también

Funciones de la API de servidor HTTP versión 1.0

HttpAddUrl

HttpCreateRequestQueue