Converts a character string to a network address.
The function has the following parameters:
- The string to be converted.
- On output, the equivalent network address.
The function returns one of the following values:
- If successful,
- If unsuccessful,
PR_FAILURE. You can retrieve the reason for the failure by calling
For IPv4 addresses, the input string represents numbers in the Internet standard "." notation. IPv6 addresses are indicated as strings using ":" characters separating octets, with numerous caveats for shortcutting (see RFC #1884). If the NSPR library and the host are configured to support IPv6, both formats are supported. Otherwise, use of anything other than IPv4 dotted notation results in an error.