Función HttpFlushResponseCache (http.h)

La función HttpFlushResponseCache quita de la caché de LA API del servidor HTTP asociada a una cola de solicitudes determinada todos los fragmentos de respuesta que tienen un nombre cuya parte del sitio coincide con un urlPrefix especificado. La aplicación debe haber llamado previamente HttpAddUrl o HttpAddUrlToUrlGroup para agregar este urlPrefix o un prefijo válido a la cola de solicitudes en cuestión y, a continuación, llamar a HttpAddFragmentToCache para almacenar en caché el fragmento o fragmentos de respuesta asociados.

Sintaxis

HTTPAPI_LINKAGE ULONG HttpFlushResponseCache(
  [in] HANDLE       RequestQueueHandle,
  [in] PCWSTR       UrlPrefix,
  [in] ULONG        Flags,
  [in] LPOVERLAPPED Overlapped
);

Parámetros

[in] RequestQueueHandle

Controle a la cola de solicitudes con la que está asociada esta memoria caché. Se crea una cola de solicitudes y su identificador devuelto por una llamada a la función HttpCreateRequestQueue .

Windows Server 2003 con SP1 y Windows XP con SP2: El identificador de la cola de solicitudes se crea mediante la función HttpCreateHttpHandle .

[in] UrlPrefix

Puntero a una cadena UrlPrefix para que coincida con la parte del sitio de los nombres de fragmentos. La aplicación debe haber llamado previamente HttpAddUrl para agregar este urlPrefix o un prefijo válido a la cola de solicitudes en cuestión y, a continuación, llamar a HttpAddFragmentToCache para almacenar en caché el fragmento de respuesta asociado.

[in] Flags

Este parámetro puede contener la marca siguiente:

HTTP_FLUSH_RESPONSE_FLAG_RECURSIVE

Hace que los fragmentos de respuesta que tengan nombres en los que la parte del sitio sea un descendiente jerárquico del urlPrefix especificado que se va a quitar de la memoria caché de fragmentos, además de esos fragmentos que tienen partes del sitio que coinciden directamente.

[in] Overlapped

Para las llamadas asincrónicas, establezca pOverlapped para que apunte a una estructura SUPERPUESTA o para llamadas sincrónicas, establézcalo en NULL.

Una llamada sincrónica se bloquea hasta que se complete la operación de caché, mientras que una llamada asincrónica devuelve inmediatamente ERROR_IO_PENDING y la aplicación que realiza la llamada usa puertos de finalización getOverlappedResult o de E/S para determinar cuándo se completa la operación. Para obtener más información sobre el uso de estructuras SUPERPUESTAs para la sincronización, vea Sincronización y entrada y salida superpuestas.

Valor devuelto

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

Si la función se usa de forma asincrónica, un valor devuelto de ERROR_IO_PENDING indica que la solicitud de caché se pone en cola y se completa más adelante a través de mecanismos de finalización de E/S superpuestos normales.

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

Requisitos

Consulte también

Funciones de la API de servidor HTTP versión 1.0

HttpAddFragmentToCache

HttpReadFragmentFromCache