IXpsOMPageReference::DiscardPage method

Discards the page from memory.

Syntax

HRESULT DiscardPage();

Parameters

This method has no parameters.

Return value

If the method succeeds, it returns S_OK; otherwise, it returns an HRESULT error code.

Return code Description
S_OK

The method succeeded.

E_UNEXPECTED

DiscardPage has been called more than once or the page has not been loaded.

 

Remarks

If SetPage has not been called, calling DiscardPage and then GetPage will return the virtualized page from the source package. If SetPage has been called, calling DiscardPage and then GetPage will return NULL.

If the page referenced by this IXpsOMPageReference interface has been constructed entirely in memory and does not have a corresponding file, DiscardPage will delete the page from memory and the page's content will be lost. If the page has been constructed from a file, DiscardPage will delete the page from memory but will not alter the original file. The page can be reconstructed and read back into memory by calling GetPage.

If the page has been constructed from a file and subsequently modified, DiscardPage will discard the page from memory, and any changes made to the page will be lost. Calling GetPage after this will re-read the original content from the file.

Requirements

Minimum supported client

Windows 7, Windows Vista with SP2 and Platform Update for Windows Vista [desktop apps | Windows Store apps]

Minimum supported server

Windows Server 2008 R2, Windows Server 2008 with SP2 and Platform Update for Windows Server 2008 [desktop apps | Windows Store apps]

Header

Xpsobjectmodel.h

IDL

XpsObjectModel.idl

See also

IXpsOMPageReference

IXpsOMPageReference::GetPage

IXpsOMPageReference::SetPage

XML Paper Specification