Struct xpcom::interfaces::nsIDNSRecord

#[repr(C)]
pub struct nsIDNSRecord { /* fields omitted */ }

interface nsIDNSRecord : nsISupports

/**
 * nsIDNSRecord
 *
 * this interface represents the result of a DNS lookup.  since a DNS
 * query may return more than one resolved IP address, the record acts
 * like an enumerator, allowing the caller to easily step through the
 * list of IP addresses.
 */

Methods

impl nsIDNSRecord

pub fn coerce<T: nsIDNSRecordCoerce>(&self) -> &T

Cast this nsIDNSRecord to one of its base interfaces.

impl nsIDNSRecord

pub unsafe fn GetCanonicalName(
    &self,
    aCanonicalName: &mut nsACString
) -> nsresult

/**
     * @return the canonical hostname for this record.  this value is empty if
     * the record was not fetched with the RESOLVE_CANONICAL_NAME flag.
     *
     * e.g., www.mozilla.org --> rheet.mozilla.org
     */

readonly attribute ACString canonicalName;

pub unsafe fn GetScriptableNextAddr(
    &self,
    aPort: uint16_t,
    _retval: *mut *const nsINetAddr
) -> nsresult

/**
     * this function returns the value of the next IP address as a
     * scriptable address and increments the internal address iterator.
     *
     * @param aPort
     *        A port number to initialize the nsINetAddr with.
     *
     * @throws NS_ERROR_NOT_AVAILABLE if there is not another IP address in
     * the record.
     */

nsINetAddr getScriptableNextAddr (in uint16_t aPort);

pub unsafe fn GetNextAddrAsString(&self, _retval: &mut nsACString) -> nsresult

/**
     * this function returns the value of the next IP address as a
     * string and increments the internal address iterator.
     *
     * @throws NS_ERROR_NOT_AVAILABLE if there is not another IP address in
     * the record.
     */

ACString getNextAddrAsString ();

pub unsafe fn HasMore(&self, _retval: *mut bool) -> nsresult

/**
     * this function returns true if there is another address in the record.
     */

boolean hasMore ();

pub unsafe fn Rewind(&self) -> nsresult

/**
     * this function resets the internal address iterator to the first
     * address in the record.
     */

void rewind ();

pub unsafe fn ReportUnusable(&self, aPort: uint16_t) -> nsresult

/**
     * This function indicates that the last address obtained via getNextAddr*()
     * was not usuable and should be skipped in future uses of this
     * record if other addresses are available.
     *
     * @param aPort is the port number associated with the failure, if any.
     *        It may be zero if not applicable.
     */

void reportUnusable (in uint16_t aPort);

Methods from Deref<Target = nsISupports>

pub fn coerce<T: nsISupportsCoerce>(&self) -> &T

Cast this nsISupports to one of its base interfaces.

pub unsafe fn QueryInterface(
    &self,
    uuid: &nsIID,
    result: *mut *mut c_void
) -> nsresult

void QueryInterface (in nsIIDRef uuid, [iid_is (uuid), retval] out nsQIResult result);

pub unsafe fn AddRef(&self) -> nsrefcnt

[noscript,notxpcom] nsrefcnt AddRef ();

pub unsafe fn Release(&self) -> nsrefcnt

[noscript,notxpcom] nsrefcnt Release ();

Trait Implementations

impl XpCom for nsIDNSRecord

const IID: nsIID

IID: nsIID = nsID(4179765422, 50199, 16776, [166, 4, 8, 48, 169, 94, 126, 185])

fn query_interface<T: XpCom>(&self) -> Option<RefPtr<T>>

Perform a QueryInterface call on this object, attempting to dynamically cast it to the requested interface type. Returns Some(RefPtr) if the cast succeeded, and None otherwise.

impl RefCounted for nsIDNSRecord

unsafe fn addref(&self)

Increment the reference count.

unsafe fn release(&self)

Decrement the reference count, potentially freeing backing memory.

impl Deref for nsIDNSRecord

type Target = nsISupports

The resulting type after dereferencing.

fn deref(&self) -> &nsISupports

Dereferences the value.