httpFlushResponseCache 函数 (http.h)

HttpFlushResponseCache 函数从与给定请求队列关联的 HTTP 服务器 API 缓存中删除其网站部分与指定 UrlPrefix 匹配的名称的所有响应片段。 应用程序之前必须调用 HttpAddUrlHttpAddUrlToUrlGroup ,以将此 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