次の方法で共有


IPersistStorage::IsDirty メソッド (objidl.h)

オブジェクトが現在のストレージに最後に保存されてから変更されたかどうかを判断します。

構文

HRESULT IsDirty();

戻り値

このメソッドは、オブジェクトが変更されたことを示すS_OKを返します。 それ以外の場合は S_FALSE を返します。

注釈

オブジェクトを閉じる前に保存する必要があるかどうかを判断するには、このメソッドを使用します。 オブジェクトのダーティ フラグは、IPersistStorage::Save メソッドで条件付きでクリアされます。

たとえば、各オブジェクトに対して IPersistStorage::IsDirty メソッドを呼び出し、ダーティされているオブジェクトに対してのみ IPersistStorage::Save メソッドを呼び出すことで、ファイルの保存操作を最適化できます。

呼び出し元へのメモ

エラー リターン コードは、オブジェクトが変更されたことを示すものとして扱う必要があります。 このメソッドが明示的にS_FALSEを返さない限り、 オブジェクトを保存する必要があるとします。

実装者へのメモ

オブジェクトが含まれないオブジェクトは、ダーティ フラグをチェックして適切な結果を返すだけです。

1 つ以上の包含オブジェクトを含むコンテナーは、その包含オブジェクトのいずれかが最後に保存されてから変更されたときに設定される内部ダーティ フラグを維持する必要があります。

要件

要件
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー objidl.h

こちらもご覧ください

IPersistStorage