変更が行われた後、このメソッドは変更を保存します。
構文
HRESULT Commit();
戻り値
メソッドは IPropertyStore::Commit 、次のいずれかを返します。
| リターン コード | 説明 |
|---|---|
|
すべてのプロパティの変更がストリームまたはパスに正常に書き込まれた。 これには、メソッドが呼び出され、何も書き込まれなかったときに変更が保留中ではなかった場合が含まれます。 |
|
ストリームまたはファイルは読み取り専用です。メソッドで値を設定できませんでした。 |
|
一部またはすべての変更をファイルに書き込めませんでした。 もう 1 つの説明エラーは、E_FAILの代わりに使用できます。 |
解説
メソッドが Commit 戻る前に、 メソッドによって使用されるように初期化されたファイル ストリームまたはパスを解放します。 したがって、戻り値の後Commitに IPropertyStore メソッドは成功しません。 その時点で、E_FAILが返されます。
プロパティ ハンドラーは、プロセスが異常終了した場合やエラーが発生した場合でも、プロパティの Commit 変更が有効な宛先ファイルになるようにする必要があります。
要件
| サポートされている最小のクライアント | Windows Vista 以降のバージョンの Windows オペレーティング システムで使用できます。 |
| 対象プラットフォーム | ユニバーサル |
| Header | propsys.h |
| Library | Propsys.idl |
| IRQL | すべてのレベル |