Partilhar via

CRegKey::NotifyChangeKeyValue

  • Artigo

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

Dica

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