HttpFlushResponseCache 函式 (HTTP.h)
HttpFlushResponseCache函式會從與指定要求佇列相關聯的 HTTP Server API 快取中移除所有具有網站部分符合指定 UrlPrefix 之名稱的回應片段。 應用程式先前必須呼叫 HttpAddUrl或 HttpAddUrlToUrlGroup ,才能將此 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 完成機制完成。
如果函式失敗,傳回值就是下列其中一個錯誤碼。
值 | 意義 |
---|---|
|
其中一個參數無效。 |
|
WinError.h 中定義的 系統錯誤碼 。 |
需求
最低支援的用戶端 | Windows Vista、Windows XP 與 SP2 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2003 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | HTTP.h |
程式庫 | Httpapi.lib |
Dll | Httpapi.dll |