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.

Valor	Significado
ERROR_INVALID_PARAMETER	Uno de los parámetros no es válido.
Otros	Código de error del sistema definido en WinError.h.

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

HttpAddFragmentToCache

HttpReadFragmentFromCache