nsIDNSService
[scriptable, uuid(c1a56a45-8fa3-44e6-9f01-38c91c858cf9)]
interface nsIDNSService : nsISupports

Constants

 Listed below are the various flags that may be OR'd together to form
 the aFlags parameter passed to asyncResolve() and resolve().


 if set, this flag suppresses the internal DNS lookup cache.
const unsigned long RESOLVE_BYPASS_CACHE = 1 
 if set, the canonical name of the specified host will be queried.
const unsigned long RESOLVE_CANONICAL_NAME = 2 
 if set, the query is given lower priority. Medium takes precedence
 if both are used.
const unsigned long RESOLVE_PRIORITY_MEDIUM = 4 

          

  
  const
  
    unsigned long  
  RESOLVE_PRIORITY_LOW = 8

        

              

          
 if set, indicates request is speculative. Speculative requests 
 return errors if prefetching is disabled by configuration.


          

  
  const
  
    unsigned long  
  RESOLVE_SPECULATE = 16

        

          

        
Attributes

    

              

          
 @return the hostname of the operating system.


          

  
    readonly attribute
  
    AUTF8String  
  myHostName

        

          

        
Methods

    

              

          
 kicks off an asynchronous host lookup.

 @param aHostName
        the hostname or IP-address-literal to resolve.
 @param aFlags
        a bitwise OR of the RESOLVE_ prefixed constants defined below.
 @param aListener
        the listener to be notified when the result is available.
 @param aListenerTarget
        optional parameter (may be null).  if non-null, this parameter
        specifies the nsIEventTarget of the thread on which the
        listener's onLookupComplete should be called.  however, if this
        parameter is null, then onLookupComplete will be called on an
        unspecified thread (possibly recursively).

 @return An object that can be used to cancel the host lookup.


          

  
    
    nsICancelable
  asyncResolve(in AUTF8String aHostName, in unsigned long aFlags, in nsIDNSListener aListener, in nsIEventTarget aListenerTarget)

        

              

          
 called to synchronously resolve a hostname.  warning this method may
 block the calling thread for a long period of time.  it is extremely
 unwise to call this function on the UI thread of an application.

 @param aHostName
        the hostname or IP-address-literal to resolve.
 @param aFlags
        a bitwise OR of the RESOLVE_ prefixed constants defined below.

 @return DNS record corresponding to the given hostname.
 @throws NS_ERROR_UNKNOWN_HOST if host could not be resolved.


          

  
    
    nsIDNSRecord
  resolve(in AUTF8String aHostName, in unsigned long aFlags)