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 |
|---|---|
|
Die Methode wurde erfolgreich ausgeführt. |
|
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 |