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 完成機制完成。

如果函式失敗，傳回值就是下列其中一個錯誤碼。

需求

另請參閱

HTTP 伺服器 API 1.0 版函式

HttpAddFragmentToCache

HttpReadFragmentFromCache