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 |
|---|---|
|
Uno de los parámetros no es válido. |
|
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 |