Função HttpFlushResponseCache (http.h)
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 |
---|---|
|
Um dos parâmetros é inválido. |
|
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 |