зеркало из https://github.com/mozilla/gecko-dev.git
58 строки
1.4 KiB
ReStructuredText
58 строки
1.4 KiB
ReStructuredText
PR_GetHostByAddr
|
|
================
|
|
|
|
Looks up a host entry by its network address.
|
|
|
|
|
|
Syntax
|
|
------
|
|
|
|
.. code:: eval
|
|
|
|
#include <prnetdb.h>
|
|
|
|
PRStatus PR_GetHostByAddr(
|
|
const PRNetAddr *hostaddr,
|
|
char *buf,
|
|
PRIntn bufsize,
|
|
PRHostEnt *hostentry);
|
|
|
|
|
|
Parameters
|
|
~~~~~~~~~~
|
|
|
|
The function has the following parameters:
|
|
|
|
``hostaddr``
|
|
A pointer to the IP address of host in question.
|
|
``buf``
|
|
A pointer to a buffer, allocated by the caller, that is filled in
|
|
with host data on output. All of the pointers in the ``hostentry``
|
|
structure point to data saved in this buffer. This buffer is
|
|
referenced by the runtime during a call to :ref:`PR_EnumerateHostEnt`.
|
|
``bufsize``
|
|
Number of bytes in the ``buf`` parameter. The buffer must be at least
|
|
:ref:`PR_NETDB_BUF_SIZE` bytes.
|
|
``hostentry``
|
|
This structure is allocated by the caller. On output, this structure
|
|
is filled in by the runtime if the function returns ``PR_SUCCESS``.
|
|
|
|
|
|
Returns
|
|
~~~~~~~
|
|
|
|
The function returns one of the following values:
|
|
|
|
- If successful, ``PR_SUCCESS``.
|
|
- If unsuccessful, ``PR_FAILURE``. You can retrieve the reason for the
|
|
failure by calling :ref:`PR_GetError`.
|
|
|
|
|
|
Description
|
|
~~~~~~~~~~~
|
|
|
|
:ref:`PR_GetHostByAddr` is used to perform reverse lookups of network
|
|
addresses. That is, given a valid network address (of type
|
|
:ref:`PRNetAddr`), :ref:`PR_GetHostByAddr` discovers the address' primary
|
|
name, any aliases, and any other network addresses for the same host.
|