CRegKey::NotifyChangeKeyValue
Diese Methode benachrichtigt den Aufrufer über Änderungen an den Attributen oder am Inhalt des offenen Registrierungsschlüssels.
LONG NotifyChangeKeyValue(
BOOL bWatchSubtree,
DWORD dwNotifyFilter,
HANDLE hEvent,
BOOL bAsync = TRUE
) throw( );
Parameter
bWatchSubtree
Gibt ein Flag, das angibt, ob Änderungen im angegebenen Schlüssel und in allen dessen Unterschlüssel oder nur im angegebenen Schlüssel gemeldet. Wenn dieser Parameter den Wert TRUE ist, meldet die Methode Änderungen im Schlüssel und in den Unterschlüsseln. Wenn der Parameter FALSCH ist, meldet die Methode nur Änderungen im Schlüssel.dwNotifyFilter
Gibt einen Satz von Flags an, die steuern, welche sollte gemeldet werden ändert. Dieser Parameter kann eine Kombination der folgenden Werte sein:Wert
Bedeutung
REG_NOTIFY_CHANGE_NAME
Benachrichtigen Sie den Aufrufer, wenn ein Unterschlüssel hinzugefügt oder gelöscht wird.
REG_NOTIFY_CHANGE_ATTRIBUTES
Benachrichtigen Sie den Aufrufer über Änderungen an den Attributen der Schlüssel, wie den Sicherheitsbeschreibungsinformationen.
REG_NOTIFY_CHANGE_LAST_SET
Benachrichtigen Sie den Aufrufer über Änderungen an einem Wert der Schlüssel. Dies kann durch Hinzufügen oder Löschen eines Werts oder das Ändern eines vorhandenen Werts einschließen.
REG_NOTIFY_CHANGE_SECURITY
Benachrichtigen Sie den Aufrufer über Änderungen an der Sicherheitsbeschreibung des Schlüssels.
hEvent
Handle für ein Ereignis. Wenn der bAsync -Parameter den Wert TRUE hat, gibt die Methode sofort zurück und Änderungen werden gemeldet, indem Sie diesem Ereignis signalisiert. Wenn bAsync FALSCH ist, wird hEvent ignoriert.bAsync
Gibt ein Flag, das angibt, wie die Methode Änderungen gemeldet. Wenn dieser Parameter den Wert TRUE hat, gibt die Methode sofort zurück und Berichte ändert, indem sie dem angegebenen Ereignis signalisieren. Wenn dieser Parameter FALSCH hat, gibt die Methode nicht zurückgegeben, wenn eine Änderung eingetreten ist. Wenn hEvent kein gültiges Ereignis angibt, kann der bAsync-Parameter nicht den Wert TRUE sein.
Rückgabewert
Wenn die Methode erfolgreich ist, ist der Rückgabewert ERROR_SUCCESS. Wenn die Methode fehlschlägt, ist der Rückgabewert ein Fehlercode ungleich 0 (null), der in WINERROR.H. definiert ist.
Hinweise
Hinweis
Diese Methode nicht benachrichtigt den Aufrufer, wenn der angegebene Schlüssel gelöscht wird.
Weitere Informationen und ein Beispielprogramm finden Sie unter RegNotifyChangeKeyValue.
Anforderungen
Header: atlbase.h