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