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