nsIDNSService in Firefox 1.5

Implemented by

@mozilla.org/network/dns-service;1

 nsIDNSService

[scriptable, uuid(5c8ec09d-bfbf-4eaf-8a36-0d84b5c8f35b)]

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

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 aListenerEventTarget
        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 aListenerEventTarget)

 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)