Sdílet prostřednictvím


CRegKey::NotifyChangeKeyValue

Tato metoda upozorní volajícího o změny atributů nebo obsah klíče otevřít registr.

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

Parametry

  • bWatchSubtree
    Určuje příznak, který označuje, zda zprávu změny v určeném klíči a všechny jeho podklíče nebo pouze v určeném klíči.Pokud tento parametr hodnotu TRUE, metoda hlásí změny v klíči a jeho podklíčích.Pokud je parametr FALSE, metoda hlásí změny pouze v klíči.

  • dwNotifyFilter
    Určuje sadu příznaků, které řídí změny by měly být uvedeny.Tento parametr může být kombinací následujících hodnot:

    Value

    Význam

    REG_NOTIFY_CHANGE_NAME

    Upozorněte volajícího je podklíč přidány nebo odstraněny.

    REG_NOTIFY_CHANGE_ATTRIBUTES

    Oznámit volající změny atributů klíče, například informace popisovače zabezpečení.

    REG_NOTIFY_CHANGE_LAST_SET

    Oznámit volající změny hodnoty klíče.Může se jednat o přidání nebo odstranění hodnoty nebo změna existující hodnoty.

    REG_NOTIFY_CHANGE_SECURITY

    Oznámit volající změny do popisovače zabezpečení klíče.

  • hEvent
    Popisovač události.Pokud bAsync parametr má hodnotu TRUE, metoda vrátí okamžitě a změny jsou ohlášeny signalizace této události.Pokud bAsync hodnotu FALSE, hEvent je ignorována.

  • bAsync
    Určuje příznak, který určuje, jak metoda hlásí změny.Pokud tento parametr hodnotu TRUE, metoda vrátí okamžitě a hlásí změny, signalizace zadané události.Pokud tento parametr hodnotu FALSE, metoda nevrátí dokud došlo ke změně.Pokud hEvent neurčuje platnou událost bAsync parametr nemůže být pravda.

Vrácená hodnota

Pokud metoda uspěje, je vrácena hodnota ERROR_SUCCESS.Pokud metodu, vrácená hodnota je nenulová chybový kód definovaný v nezdařila.H.

Poznámky

[!POZNÁMKA]

Tato metoda neupozorní volající po odstranění zadaného klíče.

Ukázkový program a další podrobnosti naleznete v Funkce RegNotifyChangeKeyValue.

Požadavky

Záhlaví: atlbase.h

Viz také

Referenční dokumentace

Třída CRegKey