IPropertyStore::Commit メソッド (propsys.h)

変更が行われた後、このメソッドは変更を保存します。

構文

HRESULT Commit();

メソッドは IPropertyStore::Commit 、次のいずれかを返します。

リターンコード	説明
S_OK	すべてのプロパティの変更がストリームまたはパスに正常に書き込まれた。これには、メソッドが呼び出され、何も書き込まれなかったときに変更が保留中ではなかった場合が含まれます。
STG_E_ACCESSDENIED	ストリームまたはファイルは読み取り専用です。メソッドで値を設定できませんでした。
E_FAIL	一部またはすべての変更をファイルに書き込めませんでした。もう 1 つの説明エラーは、E_FAILの代わりに使用できます。

メソッドが Commit 戻る前に、メソッドによって使用されるように初期化されたファイルストリームまたはパスを解放します。したがって、戻り値の後Commitに IPropertyStore メソッドは成功しません。その時点で、E_FAILが返されます。

プロパティハンドラーは、プロセスが異常終了した場合やエラーが発生した場合でも、プロパティの Commit 変更が有効な宛先ファイルになるようにする必要があります。


サポートされている最小のクライアント	Windows Vista 以降のバージョンの Windows オペレーティングシステムで使用できます。
対象プラットフォーム	ユニバーサル
Header	propsys.h
Library	Propsys.idl
IRQL	すべてのレベル