summaryrefslogtreecommitdiffstats
path: root/chromeos/network/managed_state.h
diff options
context:
space:
mode:
Diffstat (limited to 'chromeos/network/managed_state.h')
-rw-r--r--chromeos/network/managed_state.h11
1 files changed, 8 insertions, 3 deletions
diff --git a/chromeos/network/managed_state.h b/chromeos/network/managed_state.h
index 8fc198d..f128edc 100644
--- a/chromeos/network/managed_state.h
+++ b/chromeos/network/managed_state.h
@@ -40,9 +40,14 @@ class ManagedState {
NetworkState* AsNetworkState();
DeviceState* AsDeviceState();
- // Called by NetworkStateHandler when a property changes. Returns false if
- // the property was not recognized, was not parsed successfully, or is
- // unchanged (complex properties may be assumed to have changed).
+ // Called by NetworkStateHandler when a property was received. The return
+ // value indicates if the state changed and is used to reduce the number of
+ // notifications. The only guarantee however is: If the return value is false
+ // then the state wasn't modified. This might happen because of
+ // * |key| was not recognized.
+ // * |value| was not parsed successfully.
+ // * |value| is equal to the cached property value.
+ // If the return value is true, the state might or might not be modified.
virtual bool PropertyChanged(const std::string& key,
const base::Value& value) = 0;