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,方法立即返回,并且报表通过信号通知个指定的操作更改。 当此参数是FALSE时,方法不返回,直到发生更改。 如果 hEvent 不指定有效的事件,bAsync 参数不能是TRUE。

返回值

如果方法成功,则返回值是ERROR_SUCCESS。 如果方法失败,则返回值是在WINERROR.H.定义的一个非零错误代码。

备注

备注

因此,如果指定的键删除,此方法不通知调用方。

有关详细信息和示例程序,请参见 RegNotifyChangeKeyValue

要求

Header: atlbase.h

请参见

参考

CRegKey选件类