IHttpServer::ReadFragmentFromCache 方法

从缓存中检索特定片段。

语法

virtual HRESULT ReadFragmentFromCache(  
   __in WCHAR* pszFragmentName,  
   BYTE* pvBuffer,  
   DWORD cbSize,  
   DWORD* pcbCopied  
) = 0;  

parameters

pszFragmentName
[__in]指向 的指针 WCHAR ,指定要从缓存中检索的片段。

pvBuffer
指向 BYTE 包含缓存片段的缓冲区的指针。

cbSize
一个 DWORD ,它包含缓冲区的长度(以字节为单位)。

pcbCopied
指向 DWORD 的指针,其中包含从缓存中读取的字节数。

返回值

HRESULT。 可能的值包括(但并不限于)下表中的项。

说明
S_OK 指示操作成功。
ERROR_PATH_NOT_FOUND 指示找不到 参数指定的 pszFragmentName 片段。

备注

开发人员可以分别使用 AddFragmentToCacheReadFragmentFromCacheRemoveFragmentFromCache 方法将 HTTP_DATA_CHUNK 结构添加到片段缓存,或从缓存中检索和删除 HTTP_DATA_CHUNK 结构。 这些方法为开发人员提供了使用内置 IIS 缓存来存储和检索缓存中的数据片段的少量自定义功能。

注意

Http.sys管理并拥有片段缓存。 Http.sys随时可能会覆盖或删除您定向存储的信息。 目前无法将片段缓存中的信息锁定为非易失性信息。

要求

类型 说明
客户端 - 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
Header Httpserv.h

另请参阅

IHttpServer 接口
IHttpServer::AddFragmentToCache 方法
IHttpServer::RemoveFragmentFromCache 方法