CRegKey::NotifyChangeKeyValue
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