IXpsOMPageReference::D iscardPage-Methode (xpsobjectmodel.h)

Verwirft die Seite aus dem Arbeitsspeicher.

Syntax

HRESULT DiscardPage();

Rückgabewert

Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein HRESULT-Fehlercode zurückgegeben.

Rückgabecode	Beschreibung
S_OK	Die Methode wurde erfolgreich ausgeführt.
E_UNEXPECTED	DiscardPage wurde mehrmals aufgerufen, oder die Seite wurde nicht geladen.

Hinweise

Wenn SetPage nicht aufgerufen wurde, wird durch Aufrufen von DiscardPage und GetPage die virtualisierte Seite aus dem Quellpaket zurückgegeben. Wenn SetPage aufgerufen wurde, wird durch Aufrufen von DiscardPage und GetPageNULL zurückgegeben.

Wenn die Seite, auf die von dieser IXpsOMPageReference-Schnittstelle verwiesen wird, vollständig im Arbeitsspeicher erstellt wurde und keine entsprechende Datei enthält, löscht DiscardPage die Seite aus dem Arbeitsspeicher, und der Inhalt der Seite geht verloren. Wenn die Seite aus einer Datei erstellt wurde, löscht DiscardPage die Seite aus dem Arbeitsspeicher, ändert jedoch nicht die ursprüngliche Datei. Die Seite kann durch Aufrufen von GetPage wiederhergestellt und in den Arbeitsspeicher zurückgelesen werden.

Wenn die Seite aus einer Datei erstellt und anschließend geändert wurde, verwirft DiscardPage die Seite aus dem Arbeitsspeicher, und alle an der Seite vorgenommenen Änderungen gehen verloren. Wenn GetPage danach aufgerufen wird, wird der ursprüngliche Inhalt aus der Datei erneut gelesen.

Anforderungen

Unterstützte Mindestversion (Client)	Windows 7, Windows Vista mit SP2 und Plattformupdate für Windows Vista [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2, Windows Server 2008 mit SP2 und Plattformupdate für Windows Server 2008 [Desktop-Apps | UWP-Apps]
Zielplattform	Windows
Kopfzeile	xpsobjectmodel.h

Weitere Informationen

IXpsOMPageReference

IXpsOMPageReference::GetPage

IXpsOMPageReference::SetPage

XML Paper Specification