CRegKey::NotifyChangeKeyValue
開いているレジストリ キーの属性や内容の変更について、呼び出し元に通知します。
LONG NotifyChangeKeyValue(
BOOL bWatchSubtree,
DWORD dwNotifyFilter,
HANDLE hEvent,
BOOL bAsync = TRUE
) throw( );
パラメーター
bWatchSubtree
指定したキーと、そのすべてのサブキーまたは指定したキーのみ変更を報告するかどうかを示すフラグを指定します。このパラメーターが TRUE の場合、メソッドは、キーとサブキーの変更を報告します。パラメーターが false の場合、メソッドはキーでのみ変更を報告します。dwNotifyFilter
制御する一連のフラグを指定して報告される必要がある変更する。このパラメーターには、次の値の組み合わせです:値
説明
REG_NOTIFY_CHANGE_NAME
サブキーが追加または削除された呼び出し元に通知します。
REG_NOTIFY_CHANGE_ATTRIBUTES
セキュリティ記述子情報などのキーの属性の変更の呼び出し元は、通知します。
REG_NOTIFY_CHANGE_LAST_SET
キーの値の変更の呼び出し元に通知します。これは、追加または値を削除するか、既存の値の変更を含めることができます。
REG_NOTIFY_CHANGE_SECURITY
キーのセキュリティ記述子が変更の呼び出し元に通知します。
hEvent
イベントへのハンドル。bAsync の パラメーターが true の場合、メソッドはすぐに戻り、このイベントをシグナル状態によって報告されます。bAsync が false の場合、hEvent は無視されます。bAsync
メソッドが変更を報告するかを示すフラグを指定します。このパラメーターが TRUE の場合、メソッドはすぐに戻り、レポートには、指定されたイベントを通知することによって変更します。このパラメーターが TRUE の場合、メソッドは変更が発生するまで制御を戻しません。hEvent が有効なイベントを指定しない場合、bAsync のパラメーターが true になることはありません。
戻り値
メソッドが成功した場合は、ERROR_SUCCESS を返します。メソッドが失敗した場合、戻り値は WINERROR.H で定義されている以外のエラー コードです。
解説
[!メモ]
このメソッドは、指定したキーが削除されると呼び出し元に通知を行いません。
詳細については、サンプル プログラム、RegNotifyChangeKeyValueを参照してください。
必要条件
ヘッダー: atlbase.h