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`.
