<Return[R]><Top>

RegNotifyChangeKeyValue

Declare Function Api_RegNotifyChangeKeyValue& Lib "advapi32" Alias "RegNotifyChangeKeyValue" (ByVal hKey&, ByVal bWatchSubtree&, ByVal dwNotifyFilter&, ByVal hEvent&, ByVal fAsynchronous&)

Declare Function RegNotifyChangeKeyValue Lib "advapi32" (ByVal hKey As Long, ByVal bWatchSubtree As Long, ByVal dwNotifyFilter As Long, ByVal hEvent As Long, ByVal fAsynchronous As Long) As Long

指定されたレジストリキーの属性または内容が変更されようとしているときに、そのことを呼び出し側へ通知する。指定されたキーが削除されようとしているときは、呼び出し側への通知を行わないことに注意しなければならない。

パラメータ
hKey
    現在開いているキーの識別子、または次の予約済みハンドルの値のいずれかを指定する。
    HKEY_CLASSES_ROOT
    HKEY_CURRENT_CONFIG
    HKEY_CURRENT_USER
    HKEY_LOCAL_MACHINE
    HKEY_USERS
bWatchSubtree
    指定されたキーとそのすべてのサブキーの変更を通知するのか、指定されたキーのみの変更を通知するのかを示すフラグを指定する。

    TRUE を指定するとキーとそのサブキーの変更を通知し、FALSE を指定するとキーのみの変更を通知するす。
dwNotifyFilter
    通知するべき変更のタイプを制御するフラグを指定する。次の値を組み合わせて指定する。

    値                                                           

意味                                                                                                              

    REG_NOTIFY_CHANGE_NAME

サブキーの追加または削除が発生するときに、呼び出し側への通知する。

    REG_NOTIFY_CHANGE_ATTRIBUTES

　

セキュリティ記述子情報など、キーの属性の変更が発生するときに、呼び出し側への通知を

行う。

    REG_NOTIFY_CHANGE_LAST_SET

　

キー内のレジストリエントリの変更が発生したときに、呼び出しへの通知を行う。

これには、レジストリエントリの追加、削除、既存のレジストリエントリの変更が含まれる。

    REG_NOTIFY_CHANGE_SECURITY

キーのセキュリティ記述子の変更が発生するときに、呼び出し側への通知を行う。

hEvent
    イベントのハンドルを指定する。fAsynchronous パラメータで TRUE を指定すると、この関数は即座に制御を返し、イベントの発生という形

    で、変更が発生したことを通知する。fAsynchronous パラメータで FALSE を指定すると、hEvent パラメータは無視される。
fAsynchronous
    変更について関数が通知を行う方法を指定する。このパラメータで TRUE を指定すると、関数は即座に制御を返し、その後、変更が行わ

    れたときに、指定されたイベントを発生させる形でそのことを通知する。

    このパラメータで FALSE を指定すると、変更が発生するまで関数は制御を返さない。
    hEvent パラメータで有効なイベントを指定していない場合、fAsynchronous パラメータで TRUE を指定できない。

戻り値
    関数が成功すると、ERROR_SUCCESS が返る。