IXpsOMPageReference::D iscardPage メソッド (xpsobjectmodel.h)
メモリからページを破棄します。
構文
HRESULT DiscardPage();
戻り値
メソッドが成功すると、S_OKが返されます。それ以外の場合は、 HRESULT エラー コードが返されます。
| リターン コード | 説明 |
|---|---|
|
メソッドが成功しました。 |
|
DiscardPage が複数回呼び出されたか、ページが読み込まれていません。 |
注釈
SetPage が呼び出されていない場合、DiscardPage を呼び出すと、GetPage はソース パッケージから仮想化されたページを返します。 SetPage が呼び出された場合、DiscardPage を呼び出すと、GetPage は NULL を返します。
この IXpsOMPageReference インターフェイスによって参照されるページが完全にメモリ内に構築されており、対応するファイルがない場合、 DiscardPage はメモリからページを削除し、ページのコンテンツが失われます。 ページがファイルから構築されている場合、 DiscardPage はメモリからページを削除しますが、元のファイルは変更しません。 ページを再構築し、 GetPage を呼び出してメモリに読み戻すことができます。
ページがファイルから構築され、その後変更された場合、 DiscardPage はメモリからページを破棄し、ページに加えられた変更はすべて失われます。 この後 に GetPage を 呼び出すと、ファイルから元のコンテンツが再読み取りされます。
要件
| サポートされている最小のクライアント | Windows 7、Windows Vista SP2 および Windows Vista 用プラットフォーム更新プログラム [デスクトップ アプリ |UWP アプリ] |
| サポートされている最小のサーバー | Windows Server 2008 R2、Windows Server 2008 SP2 および Windows Server 2008 用プラットフォーム更新プログラム [デスクトップ アプリ |UWP アプリ] |
| 対象プラットフォーム | Windows |
| ヘッダー | xpsobjectmodel.h |