Share via

httpFlushResponseCache 函数 (http.h)

  • 项目

HttpFlushResponseCache 函数从与给定请求队列关联的 HTTP 服务器 API 缓存中删除其网站部分与指定 UrlPrefix 匹配的名称的所有响应片段。 应用程序之前必须调用 HttpAddUrl 或 HttpAddUrlToUrlGroup ，以将此 UrlPrefix 或其有效前缀添加到相关请求队列，然后调用 HttpAddFragmentToCache 来缓存关联的响应片段或片段。

语法

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

parameters

[in] RequestQueueHandle

与此缓存关联的请求队列的句柄。 创建请求队列，并通过调用 HttpCreateRequestQueue 函数返回其句柄。

Windows Server 2003 SP1 和 Windows XP SP2： 请求队列的句柄由 HttpCreateHttpHandle 函数创建。

[in] UrlPrefix

指向要与片段名称的网站部分匹配的 UrlPrefix 字符串 的指针。 应用程序之前必须调用 HttpAddUrl 将此 UrlPrefix 或其有效前缀添加到相关请求队列，然后调用 HttpAddFragmentToCache 来缓存关联的响应片段。

[in] Flags

此参数可以包含以下标志：

HTTP_FLUSH_RESPONSE_FLAG_RECURSIVE

除了具有直接匹配的网站部分的片段外，还会导致从片段缓存中删除名称为指定 UrlPrefix 的分层后代的响应片段。

[in] Overlapped

对于异步调用，请将 pOverlapped 设置为指向 OVERLAPPED 结构;对于同步调用，将其设置为 NULL。

同步调用会一直阻塞，直到缓存操作完成，而异步调用会立即返回ERROR_IO_PENDING，然后调用应用程序使用 GetOverlappedResult 或 I/O 完成端口来确定操作何时完成。 有关使用 OVERLAPPED 结构进行同步的详细信息，请参阅 同步和重叠输入和输出。

返回值

如果函数成功，则返回值NO_ERROR。

如果异步使用函数，则返回值 ERROR_IO_PENDING 指示缓存请求已排队，稍后通过正常的重叠 I/O 完成机制完成。

如果函数失败，则返回值为以下错误代码之一。

值 含义
ERROR_INVALID_PARAMETER
 其中一个参数无效。
其他
 WinError.h 中定义的 系统错误代码 。

要求

   
最低受支持的客户端 Windows Vista、Windows XP SP2 [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 http.h
Library Httpapi.lib
DLL Httpapi.dll

另请参阅

HTTP 服务器 API 版本 1.0 函数

HttpAddFragmentToCache

HttpReadFragmentFromCache