Função HttpFlushResponseCache (http.h)

Artigo
08/24/2023

A função HttpFlushResponseCache remove do cache da API do Servidor HTTP associado a uma determinada fila de solicitação todos os fragmentos de resposta que têm um nome cuja parte do site corresponde a um UrlPrefix especificado. O aplicativo deve ter chamado HttpAddUrl ou HttpAddUrlToUrlGroup para adicionar esse UrlPrefix ou um prefixo válido dele à fila de solicitação em questão e, em seguida, chamado HttpAddFragmentToCache para armazenar em cache o fragmento ou fragmentos de resposta associados.

Sintaxe

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

Parâmetros

[in] RequestQueueHandle

Manipule para a fila de solicitação à qual esse cache está associado. Uma fila de solicitação é criada e seu identificador retornado por uma chamada para a função HttpCreateRequestQueue .

Windows Server 2003 com SP1 e Windows XP com SP2: O identificador para a fila de solicitação é criado pela função HttpCreateHttpHandle .

[in] UrlPrefix

Ponteiro para uma cadeia de caracteres UrlPrefix para corresponder à parte do site de nomes de fragmento. O aplicativo deve ter chamado HttpAddUrl anteriormente para adicionar esse UrlPrefix ou um prefixo válido dele à fila de solicitação em questão e, em seguida, chamado HttpAddFragmentToCache para armazenar em cache o fragmento de resposta associado.

[in] Flags

Esse parâmetro pode conter o seguinte sinalizador:

HTTP_FLUSH_RESPONSE_FLAG_RECURSIVE

Faz com que fragmentos de resposta que têm nomes nos quais a parte do site é um descendente hierárquico do UrlPrefix especificado sejam removidos do cache de fragmentos, além dos fragmentos que têm partes do site que correspondem diretamente.

[in] Overlapped

Para chamadas assíncronas, defina pOverlapped para apontar para uma estrutura OVERLAPPED ou, para chamadas síncronas, defina-a como NULL.

Uma chamada síncrona bloqueia até que a operação de cache seja concluída, enquanto uma chamada assíncrona retorna imediatamente ERROR_IO_PENDING e o aplicativo de chamada usa as portas de conclusão GetOverlappedResult ou de E/S para determinar quando a operação é concluída. Para obter mais informações sobre como usar estruturas OVERLAPPED para sincronização, consulte Sincronização e entrada e saída sobrepostas.

Valor retornado

Se a função for bem-sucedida, o valor retornado será NO_ERROR.

Se a função for usada de forma assíncrona, um valor retornado de ERROR_IO_PENDING indicará que a solicitação de cache é enfileirada e concluída posteriormente por meio de mecanismos normais de conclusão de E/S sobrepostos.

Se a função falhar, o valor retornado será um dos seguintes códigos de erro.

Valor	Significado
ERROR_INVALID_PARAMETER	Um dos parâmetros é inválido.
Outros	Um código de erro do sistema definido em WinError.h.

Requisitos


Cliente mínimo com suporte	Windows Vista, Windows XP com SP2 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	http.h
Biblioteca	Httpapi.lib
DLL	Httpapi.dll

Confira também

Funções da API do Servidor HTTP versão 1.0

HttpAddFragmentToCache

HttpReadFragmentFromCache