PR_GetHostByAddr

根据网络地址查找主机条目。

语法

#include <prnetdb.h>

PRStatus PR_GetHostByAddr(
  const PRNetAddr *hostaddr,
  char *buf,
  PRIntn bufsize,
  PRHostEnt *hostentry);

参数

该函数具有以下参数

hostaddr

指向目标主机 IP 地址的指针。

buf

指向缓冲区的指针，由调用方分配，在输出时填充主机数据。 hostentry 结构中的所有指针都指向保存在此缓冲区中的数据。此缓冲区在调用 PR_EnumerateHostEnt 期间由运行时引用。

bufsize

buf 参数中的字节数。缓冲区必须至少为 PR_NETDB_BUF_SIZE 字节。

hostentry

此结构由调用方分配。在输出时，如果函数返回 PR_SUCCESS，则此结构由运行时填充。

返回值

该函数返回以下值之一

  • 如果成功，则返回 PR_SUCCESS。

  • 如果失败，则返回 PR_FAILURE。可以通过调用 PR_GetError 来检索失败的原因。

描述

PR_GetHostByAddr 用于执行网络地址的反向查找。也就是说，给定一个有效的网络地址（类型为 PRNetAddr）， PR_GetHostByAddr 会发现该地址的主机名、任何别名以及同一主机的任何其他网络地址。