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

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

構文

HRESULT IsDirty();

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

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

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

OLE 提供のモニカーインターフェイスの IPersistStream::IsDirty メソッドの OLE 提供の実装では、内部状態が変更されないため、常にS_FALSEが返されることに注意してください。

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