CRegKey::NotifyChangeKeyValue

Artigo
02/25/2013

Este método notifica o chamador sobre alterações aos atributos ou ao conteúdo da chave do Registro aberta.

LONG NotifyChangeKeyValue(
   BOOL bWatchSubtree,
   DWORD dwNotifyFilter,
   HANDLE hEvent,
   BOOL bAsync = TRUE 
) throw( );

Parâmetros

bWatchSubtree
Especifica um sinalizador que indica se o reporting alterações na chave especificada e em todas as suas subchaves ou somente na chave especificada.Se esse parâmetro é TRUE, o método relata alterações na chave e em suas subchaves.Se o parâmetro é FALSO, o método relata alterações somente na chave.

dwNotifyFilter
Especifica um conjunto de sinalizadores que controlam que muda deve ser relatado.Este parâmetro pode ser uma combinação dos seguintes valores:

Valor	Significado
REG_NOTIFY_CHANGE_NAME	Notificar o chamador se uma subchave é adicionada ou excluída.
REG_NOTIFY_CHANGE_ATTRIBUTES	Notificar o chamador de alterações aos atributos de chave, como informações de descritor de segurança.
REG_NOTIFY_CHANGE_LAST_SET	Notificar o chamador das alterações a um valor de chave.Isso pode incluir adicionar ou excluir um valor, ou alterar um valor existente.
REG_NOTIFY_CHANGE_SECURITY	Notificar o chamador de alterações ao descritor de segurança de chave.

hEvent
Manipular um evento.Se o parâmetro é de bAsync TRUE, o método retorna imediatamente e as alterações são relatadas sinalização este evento.Se bAsync é FALSO, hEvent será ignorado.
bAsync
Especifica um sinalizador que indica como o método relata alterações.Se esse parâmetro é TRUE, o método retorna imediatamente e relatórios alterações sinalização o evento especificado.Quando esse parâmetro é FALSO, o método não retorna até que uma mudança ocorre.Se hEvent não especifica um evento válido, o parâmetro de bAsync não pode ser TRUE.

Valor de retorno

Se o método for bem sucedida, o valor de retorno é ERROR_SUCCESS.Se o método falhar, o valor de retorno é um código de erro diferente de zero definido em. WINERROR.H.

Comentários

Observação
Este método não notifica o chamador se a chave especificada é excluída.

Para obter detalhes e um programa de exemplo, consulte RegNotifyChangeKeyValue.

Requisitos

Cabeçalho: atlbase.h

Consulte também

Referência

Classe de CRegKey

Compartilhar via