IXpsOMPageReference：:D iscardPage 方法 (xpsobjectmodel.h)
捨棄記憶體中的頁面。
Syntax
HRESULT DiscardPage();
傳回值
如果方法成功，它會傳回S_OK;否則會傳回 HRESULT 錯誤碼。
| 傳回碼 | 描述 |
|---|---|
|
此方法已成功。 |
|
DiscardPage 已呼叫一次以上，或尚未載入頁面。 |
備註
如果 尚未呼叫 SetPage ，則呼叫 DiscardPage ，然後 GetPage 會從來源套件傳回虛擬化頁面。 如果已呼叫 SetPage ，則呼叫 DiscardPage ，然後 GetPage 會傳回 Null。
如果這個 IXpsOMPageReference 介面所參考的頁面已完全建構在記憶體中，而且沒有對應的檔案， DiscardPage 將會從記憶體中刪除頁面，而且頁面的內容將會遺失。 如果頁面是從檔案建構的， DiscardPage 會從記憶體中刪除頁面，但不會改變原始檔案。 呼叫 GetPage，即可重新建構頁面並讀回記憶體中。
如果頁面已從檔案建構並後續修改， DiscardPage 會捨棄記憶體中的頁面，而且對頁面所做的任何變更都會遺失。 在之後呼叫 GetPage 將會從檔案重新讀取原始內容。
規格需求
| 最低支援的用戶端 | 適用于 Windows Vista 的 Windows 7、Windows Vista SP2 和平臺更新 [傳統型應用程式 |UWP 應用程式] |
| 最低支援的伺服器 | Windows Server 2008 R2、Windows Server 2008 SP2 和 Platform Update for Windows Server 2008 [傳統型應用程式 |UWP 應用程式] |
| 目標平台 | Windows |
| 標頭 | xpsobjectmodel.h |