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 |
|---|---|
|
La aplicación que realiza la llamada no llamó a HttpInitialize antes de llamar a esta función. |
|
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 |