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.
this function copies the value of the next IP address into the
given NetAddr struct and increments the internal address iterator.
@throws NS_ERROR_NOT_AVAILABLE if there is not another IP address in
the record.
| aPort | A port number to initialize the NetAddr with. |
this function returns the value of the next IP address as a
scriptable address and increments the internal address iterator.
@throws NS_ERROR_NOT_AVAILABLE if there is not another IP address in
the record.
| aPort | A port number to initialize the nsINetAddr with. |
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.
this function returns true if there is another address in the record.
this function resets the internal address iterator to the first
address in the record.
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.
| aPort | is the port number associated with the failure, if any. It may be zero if not applicable. |
@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