/* This Source Code Form is subject to the terms of the Mozilla Public
 * License, v. 2.0. If a copy of the MPL was not distributed with this
 * file, You can obtain one at http://mozilla.org/MPL/2.0/. */

#include "nsISupports.idl"

interface nsIWifiListener;

[scriptable, uuid(F289701E-D9AF-4685-BC2F-E4226FF7C018)]
interface nsIWifiMonitor : nsISupports
{
  /*
   * startWatching
   * aListener will be called once, then each time the list of wifi access
   * points change.  The wifi access point list will be updated when our
   * network changes, or on a regular interval if we are on a mobile network.
   * If aForcePolling is true then we will always poll as long as this
   * listener is watching.
   */
  void startWatching(in nsIWifiListener aListener, in boolean aForcePolling);

  /*
   * stopWatching
   * cancels all notifications to the |aListener|.
   */
  void stopWatching(in nsIWifiListener aListener);
};