共用方式為


HttpFlushResponseCache 函式 (HTTP.h)

HttpFlushResponseCache函式會從與指定要求佇列相關聯的 HTTP Server API 快取中移除所有具有網站部分符合指定 UrlPrefix 之名稱的回應片段。 應用程式先前必須呼叫 HttpAddUrlHttpAddUrlToUrlGroup ,才能將此 UrlPrefix 或它的有效前置詞新增至有問題的要求佇列,然後呼叫 HttpAddFragmentToCache 來快取相關聯的回應片段或片段。

語法

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

參數

[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 設定為指向 重迭 結構,或針對同步呼叫,將它設定為 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
程式庫 Httpapi.lib
Dll Httpapi.dll

另請參閱

HTTP 伺服器 API 1.0 版函式

HttpAddFragmentToCache

HttpReadFragmentFromCache