從快取擷取特定片段。
語法
virtual HRESULT ReadFragmentFromCache(
__in WCHAR* pszFragmentName,
BYTE* pvBuffer,
DWORD cbSize,
DWORD* pcbCopied
) = 0;
參數
pszFragmentName
[__in]的指標 WCHAR ,指定要從快取擷取的片段。
pvBuffer
包含快取片段之緩衝區的指標 BYTE 。
cbSize
, DWORD 包含緩衝區的長度,以位元組為單位。
pcbCopied
的指標 DWORD ,其中包含從快取讀取的位元組數目。
傳回值
HRESULT。 可能的值包括 (但不限於) 下表中的這些值。
| 值 | 描述 |
|---|---|
| S_OK | 表示作業成功。 |
| ERROR_PATH_NOT_FOUND | 表示找不到 參數所 pszFragmentName 指定的片段。 |
備註
開發人員可以使用 AddFragmentToCache、 ReadFragmentFromCache 和 RemoveFragmentFromCache 方法,分別將 HTTP_DATA_CHUNK 結構新增至片段快取,或從快取擷取和移除 HTTP_DATA_CHUNK 結構。 這些方法可讓開發人員使用內建 IIS 快取,在快取中儲存和擷取資料片段,
注意
Http.sys管理並擁有片段快取。 您可以隨時Http.sys覆寫或刪除您導向儲存的資訊。 目前沒有任何方法會將片段快取中的資訊鎖定為非volatiatile 資訊。
規格需求
| 類型 | 描述 |
|---|---|
| Client | - Windows Vista 上的 IIS 7.0 - Windows 7 上的 IIS 7.5 - Windows 8 上的 IIS 8.0 - Windows 10上的 IIS 10.0 |
| 伺服器 | - Windows Server 2008 上的 IIS 7.0 - Windows Server 2008 R2 上的 IIS 7.5 - Windows Server 2012 上的 IIS 8.0 - Windows Server 2012 R2 上的 IIS 8.5 - Windows Server 2016上的 IIS 10.0 |
| 產品 | - IIS 7.0、IIS 7.5、IIS 8.0、IIS 8.5、IIS 10.0 - IIS Express 7.5、IIS Express 8.0、IIS Express 10.0 |
| 標頭 | Httpserv.h |
另請參閱
IHttpServer 介面
IHttpServer::AddFragmentToCache 方法
IHttpServer::RemoveFragmentFromCache 方法