IXpsOMPageReference::D iscardPage 方法 (xpsobjectmodel.h)

放弃内存中的页。

语法

HRESULT DiscardPage();

返回值

如果该方法成功,则返回S_OK;否则,它将返回 HRESULT 错误代码。

返回代码 说明
S_OK
方法成功。
E_UNEXPECTED

已多次调用 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

另请参阅

IXpsOMPageReference

IXpsOMPageReference::GetPage

IXpsOMPageReference::SetPage

XML 纸张规范