netwerk/dns/nsIDNSListener.idl

   1 /* This Source Code Form is subject to the terms of the Mozilla Public
   2  * License, v. 2.0. If a copy of the MPL was not distributed with this
   3  * file, You can obtain one at http://mozilla.org/MPL/2.0/. */
   4
   5 #include "nsISupports.idl"
   6
   7 interface nsICancelable;
   8 interface nsIDNSRecord;
   9
  10 /**
  11  * nsIDNSListener
  12  */
  13 [scriptable, function, uuid(27d49bfe-280c-49e0-bbaa-f6200c232c3d)]
  14 interface nsIDNSListener : nsISupports
  15 {
  16     /**
  17      * called when an asynchronous host lookup completes.
  18      *
  19      * @param aRequest
  20      *        the value returned from asyncResolve.
  21      * @param aRecord
  22      *        the DNS record corresponding to the hostname that was resolved.
  23      *        this parameter is null if there was an error.
  24      * @param aStatus
  25      *        if the lookup failed, this parameter gives the reason.
  26      */
  27     void onLookupComplete(in nsICancelable aRequest,
  28                           in nsIDNSRecord  aRecord,
  29                           in nsresult      aStatus);
  30 };
  31
  32 /**
  33  * nsIDNSListenerProxy:
  34  *
  35  * Must be implemented by classes that wrap the original listener passed to
  36  * nsIDNSService.AsyncResolve, so we have access to original listener for
  37  * comparison purposes.
  38  */
  39 [uuid(60eff0e4-6f7c-493c-add9-1cbea59063ad)]
  40 interface nsIDNSListenerProxy : nsISupports
  41 {
  42   /*
  43    * The original nsIDNSListener which requested hostname resolution.
  44    */
  45   readonly attribute nsIDNSListener originalListener;
  46 };