PR_GetHostByName

根据名称查找主机。

语法

#include <prnetdb.h>

PRStatus PR_GetHostByName(
  const char *hostname,
  char *buf,
  PRIntn bufsize,
  PRHostEnt *hostentry);

参数

该函数具有以下参数

hostname

定义目标主机名的字符字符串。

buf

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

bufsize

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

hostentry

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

返回值

该函数返回以下值之一

• 如果成功，则返回 PR_SUCCESS。

• 如果失败，则返回 PR_FAILURE。可以通过调用 PR_GetError 获取失败原因。