Поделиться через


Метод 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, Windows Vista с пакетом обновления 2 (SP2) и обновление платформы для Windows Vista [классические приложения | Приложения UWP]
Минимальная версия сервера Windows Server 2008 R2, Windows Server 2008 с пакетом обновления 2 (SP2) и Обновление платформы для Windows Server 2008 [классические приложения | Приложения UWP]
Целевая платформа Windows
Header xpsobjectmodel.h

См. также раздел

IXpsOMPageReference

IXpsOMPageReference::GetPage

IXpsOMPageReference::SetPage

XPS