RegFlushKey

指定した開かれているレジストリキーのすべての属性をレジストリに書き込む。

RegFlushKey hKey

hKey : [intptr] 開かれているレジストリキーへのハンドル。キーは KEY_QUERY_VALUE アクセス権で開かれている必要がある。詳細はレジストリキーのセキュリティとアクセス権を参照のこと。

(プラグイン / モジュール : advapi32.dll)

解説

指定した開かれているレジストリキーのすべての属性をレジストリに書き込む。

[戻り値]
関数が成功した場合、戻り値は ERROR_SUCCESS となる。関数が失敗した場合、戻り値は Winerror.h で定義された 0
以外のエラーコードとなる。FormatMessage 関数に FORMAT_MESSAGE_FROM_SYSTEM
フラグを指定して呼び出すと、エラーの一般的な説明を取得できる。

[備考]
RegFlushKey
の呼び出しは非常にコストの高い操作で、ディスク帯域を消費し、フラッシュ操作が完了するまでフラッシュ対象のレジストリハイブ内のすべてのキーに対する変更を全プロセスでブロックするため、システム全体のパフォーマンスに大きな影響を与える。RegFlushKey
は、変更直後にレジストリの変更をディスクに永続化することをアプリケーションが保証しなければならない場合にのみ明示的に呼び出すべきである。キーに加えられたすべての変更は、ディスクにフラッシュされなくても他のプロセスから参照可能である。代わりに、レジストリは一定時間ごとにレジストリの変更をディスクにフラッシュする「遅延フラッシュ」機構を持っている。この通常のフラッシュ操作に加え、システムシャットダウン時にもレジストリの変更がディスクにフラッシュされる。「遅延フラッシュ」に任せることが、ディスク上のレジストリストアへの書き込みを管理する最も効率的な方法である。RegFlushKey
関数は、指定したキーを含むハイブのすべてのデータがディスク上のレジストリストアに書き込まれた時のみ復帰する。RegFlushKey
関数は、前回の遅延フラッシュまたはシステム起動以降に変更されたハイブ内の他のキーのデータも書き出す。RegFlushKey
から復帰した後は、RegCloseKey を使用してレジストリキーへのハンドルを閉じる。

情報