Looks up a host by name. Equivalent to
getaddrinfo(host, NULL, ...) of RFC 3493.
#include <prnetdb.h> PRAddrInfo *PR GetAddrInfoByName( const char *hostname, PRUint16 af, PRIntn flags);
The function has the following parameters:
- The character string defining the host name of interest.
- The address family. May be
- May be either
PR_AI_ADDRCONFIG | PR_AI_NOCANONNAME. Include
PR_AI_NOCANONNAMEto suppress the determination of the canonical name corresponding to
The function returns one of the following values:
- If successful, a pointer to the opaque
PRAddrInfostructure containing the results of the host lookup. Use
PR_EnumerateAddrInfoto inspect the
PRNetAddrvalues stored in this structure. When no longer needed, this pointer must be destroyed with a call to
- If unsuccessful,
NULL. You can retrieve the reason for the failure by calling