Add WiFi SSID getter to NetworkChangeNotifier.

net/base/network_change_notifier.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 NET_BASE_NETWORK_CHANGE_NOTIFIER_H_
 #define NET_BASE_NETWORK_CHANGE_NOTIFIER_H_
 
+#include <string>
 #include <vector>
 
 #include "base/basictypes.h"
 #include "base/observer_list_threadsafe.h"
 #include "base/time/time.h"
 #include "net/base/net_export.h"
 
 class GURL;
 
 namespace net {
@@ skipping 179 matching lines @@
     DISALLOW_COPY_AND_ASSIGN(MaxBandwidthObserver);
   };
 
   virtual ~NetworkChangeNotifier();
 
   // See the description of NetworkChangeNotifier::GetConnectionType().
   // Implementations must be thread-safe. Implementations must also be
   // cheap as it is called often.
   virtual ConnectionType GetCurrentConnectionType() const = 0;
 
+  // See the description of NetworkChangeNotifier::GetConnectionType.
+  // Implementations must be thread-safe.
+  virtual std::string GetCurrentWiFiSSID() const = 0;
+
   // Replaces the default class factory instance of NetworkChangeNotifier class.
   // The method will take over the ownership of |factory| object.
   static void SetFactory(NetworkChangeNotifierFactory* factory);
 
   // Creates the process-wide, platform-specific NetworkChangeNotifier.  The
   // caller owns the returned pointer.  You may call this on any thread.  You
   // may also avoid creating this entirely (in which case nothing will be
   // monitored), but if you do create it, you must do so before any other
   // threads try to access the API below, and it must outlive all other threads
   // which might try to use it.
   static NetworkChangeNotifier* Create();
 
   // Returns the connection type.
   // A return value of |CONNECTION_NONE| is a pretty strong indicator that the
   // user won't be able to connect to remote sites. However, another return
   // value doesn't imply that the user will be able to connect to remote sites;
   // even if some link is up, it is uncertain whether a particular connection
   // attempt to a particular remote site will be successful.
   // The returned value only describes the connection currently used by the
   // device, and does not take into account other machines on the network. For
   // example, if the device is connected using Wifi to a 3G gateway to access
   // the internet, the connection type is CONNECTION_WIFI.
   static ConnectionType GetConnectionType();
 
+  // Returns the SSID of the current Wi-Fi connection.
+  // A non empty string return value means that the current connection is a
+  // Wi-Fi connection. However, an empty string doesn't necessarily mean the
+  // connection isn't Wi-Fi, any error getting the SSID results in an empty
+  // string.
+  static std::string GetWiFiSSID();
+
   // Returns a theoretical upper limit on download bandwidth, potentially based
   // on underlying connection type, signal strength, or some other signal. The
   // default mapping of connection type to maximum bandwidth is provided in the
   // NetInfo spec: http://w3c.github.io/netinfo/. Host-specific application
   // permissions may be required, please see host-specific declaration for more
   // information.
   static double GetMaxBandwidth();
 
   // Retrieve the last read DnsConfig. This could be expensive if the system has
   // a large HOSTS file.
@@ skipping 199 matching lines @@
 
   // Set true to disable non-test notifications (to prevent flakes in tests).
   bool test_notifications_only_;
 
   DISALLOW_COPY_AND_ASSIGN(NetworkChangeNotifier);
 };
 
 }  // namespace net
 
 #endif  // NET_BASE_NETWORK_CHANGE_NOTIFIER_H_