IXpsOMPageReference::D iscardPage 方法 (xpsobjectmodel.h)
放弃内存中的页。
语法
HRESULT DiscardPage();
返回值
如果该方法成功,则返回S_OK;否则,它将返回 HRESULT 错误代码。
返回代码 | 说明 |
---|---|
|
方法成功。 |
|
已多次调用 DiscardPage 或尚未加载页面。 |
注解
如果尚未调用 SetPage ,则调用 DiscardPage ,然后 GetPage 将从源包返回虚拟化页。 如果已调用 SetPage ,则调用 DiscardPage ,然后 GetPage 将返回 NULL。
如果此 IXpsOMPageReference 接口引用的页面完全在内存中构造,并且没有相应的文件, 则 DiscardPage 将从内存中删除该页,并且页面的内容将丢失。 如果页面是从文件构造的, DiscardPage 将从内存中删除该页,但不会更改原始文件。 可以通过调用 GetPage 重新构造页面并将其读回内存中。
如果页面已从文件构造并随后进行了修改, 则 DiscardPage 将从内存中丢弃该页,并且对页面所做的任何更改都将丢失。 在此之后调用 GetPage 将从文件中重新读取原始内容。
要求
最低受支持的客户端 | Windows 7、带 SP2 的 Windows Vista 和适用于 Windows Vista 的平台更新 [桌面应用 |UWP 应用] |
最低受支持的服务器 | Windows Server 2008 R2、Windows Server 2008 SP2 和适用于 Windows Server 2008 的平台更新 [桌面应用 |UWP 应用] |
目标平台 | Windows |
标头 | xpsobjectmodel.h |