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 完成机制完成。
如果函数失败,则返回值为以下错误代码之一。
值 | 含义 |
---|---|
|
其中一个参数无效。 |
|
WinError.h 中定义的 系统错误代码 。 |
要求
最低受支持的客户端 | Windows Vista、Windows XP SP2 [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2003 [仅限桌面应用] |
目标平台 | Windows |
标头 | http.h |
Library | Httpapi.lib |
DLL | Httpapi.dll |