Поделиться через

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 Class