[CrOS Tether] Add the HasConnectedToHost network field to NetworkStateHandler.

chromeos/network/network_state_handler.h

 // Copyright (c) 2012 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 #ifndef CHROMEOS_NETWORK_NETWORK_STATE_HANDLER_H_
 #define CHROMEOS_NETWORK_NETWORK_STATE_HANDLER_H_
 
 #include <map>
 #include <memory>
 #include <set>
@@ skipping 190 matching lines @@
       bool configured_only) const;
 
   // Finds and returns the NetworkState associated with |guid| or NULL if not
   // found. This returns all entries (IsInProfile() may be true or false).
   const NetworkState* GetNetworkStateFromGuid(const std::string& guid) const;
 
   // Creates a Tether NetworkState that has no underlying shill type or
   // service. When initially created, it does not actually represent a real
   // network. The |guid| provided must be non-empty. If a network with |guid|
   // already exists, this method will do nothing. Use the provided |guid| to
-  // refer to and fetch this NetworkState in the future.
-  // NOTE: only GetNetworkStateFromGuid is supported to fetch "tether"
-  // NetworkStates.
+  // refer to and fetch this NetworkState in the future. Note that the
+  // |has_connected_to_host| parameter refers to whether the current device has
+  // already connected to the tether host device providing this Tether network
+  // in the past.
   void AddTetherNetworkState(const std::string& guid,
                              const std::string& name,
                              const std::string& carrier,
                              int battery_percentage,
-                             int signal_strength);
+                             int signal_strength,
+                             bool has_connected_to_host);
 
   // Updates the tether properties (carrier, battery percentage, and signal
   // strength) for a network which has already been added via
   // AddTetherNetworkState. Returns whether the update was successful.
   bool UpdateTetherNetworkProperties(const std::string& guid,
                                      const std::string& carrier,
                                      int battery_percentage,
                                      int signal_strength);
 
+  // Updates the whether the Tether network with GUID |guid| has connected to

[stevenjb, 2017/05/01 16:11:31]

s/the whether/whether/

[Kyle Horimoto, 2017/05/01 16:56:27]

Done.

+  // the host device before, setting the value to true. Note that there is no
+  // way to change this value back to false. If no network with GUID |guid| is
+  // registered or if the network is registered and its HasConnectedToHost value
+  // was already true, this function does nothing. Returns whether the value was
+  // actually changed.
+  bool SetTetherNetworkHasConnectedToHost(const std::string& guid);
+
   // Remove a Tether NetworkState, using the same |guid| passed to
-  // AddTetherNetworkState.
-  void RemoveTetherNetworkState(const std::string& guid);
+  // AddTetherNetworkState(). If no network with GUI |guid| is registered, this

[stevenjb, 2017/05/01 16:11:31]

s/GUI/GUID/ or 'id' or just 'with |guid|'

[Kyle Horimoto, 2017/05/01 16:56:27]

Done.

+  // function does nothing. Returns whether the network was actually removed.
+  bool RemoveTetherNetworkState(const std::string& guid);
 
   // Inform NetworkStateHandler that the provided Tether network with the
   // provided guid |tether_network_guid| is associated with the Wi-Fi network
   // with the provided guid |wifi_network_guid|. This Wi-Fi network can now be
   // hidden in the UI, and the Tether network will act as its proxy. Returns
   // false if the association failed (e.g., one or both networks don't exist).
   bool AssociateTetherNetworkStateWithWifiNetwork(
       const std::string& tether_network_guid,
       const std::string& wifi_network_guid);
 
@@ skipping 266 matching lines @@
 
   // Ensure that Shutdown() gets called exactly once.
   bool did_shutdown_ = false;
 
   DISALLOW_COPY_AND_ASSIGN(NetworkStateHandler);
 };
 
 }  // namespace chromeos
 
 #endif  // CHROMEOS_NETWORK_NETWORK_STATE_HANDLER_H_