Source code
Revision control
Copy as Markdown
Other Tools
# PR_GetCanonNameFromAddrInfo
Extracts the canonical name of the hostname passed to
{ref}`PR_GetAddrInfoByName`.
## Syntax
```{code}
#include <prnetdb.h>
const char *PR_GetCanonNameFromAddrInfo(const PRAddrInfo *addrInfo);
```
### Parameters
The function has the following parameters:
`addrInfo`
: A pointer to a `PRAddrInfo` structure returned by a successful call
to {ref}`PR_GetAddrInfoByName`.
### Returns
The function returns a const pointer to the canonical hostname stored in
the given `PRAddrInfo` structure. This pointer is invalidated once the
`PRAddrInfo` structure is destroyed by a call to {ref}`PR_FreeAddrInfo`.