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 interface nsIDNSByTypeRecord;
  10
  11 /**
  12  * nsIDNSListener
  13  */
  14 [scriptable, uuid(27d49bfe-280c-49e0-bbaa-f6200c232c3d)]
  15 interface nsIDNSListener : nsISupports
  16 {
  17     /**
  18      * called when an asynchronous host lookup completes.
  19      *
  20      * @param aRequest
  21      *        the value returned from asyncResolve.
  22      * @param aRecord
  23      *        the DNS record corresponding to the hostname that was resolved.
  24      *        this parameter is null if there was an error.
  25      *        depending on the type parameter passed to asyncResolve() the
  26      *        caller should QueryInterface to either nsIDNSAddrRecord or
  27      *        nsIDNSByTypeRecord.
  28      * @param aStatus
  29      *        if the lookup failed, this parameter gives the reason.
  30      */
  31     void onLookupComplete(in nsICancelable aRequest,
  32                           in nsIDNSRecord  aRecord,
  33                           in nsresult      aStatus);
  34 };