PR_GetAddrInfoByName

根据主机名查找主机。等效于 RFC 3493 中的 getaddrinfo(host, NULL, ...)。

语法

#include <prnetdb.h>

PRAddrInfo *PR_GetAddrInfoByName(
  const char *hostname,
  PRUint16 af,
  PRIntn flags);

参数

该函数具有以下参数

hostname

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

af

地址族。可以是 PR_AF_UNSPEC 或 PR_AF_INET。

flags

可以是 PR_AI_ADDRCONFIG 或 PR_AI_ADDRCONFIG | PR_AI_NOCANONNAME。包含 PR_AI_NOCANONNAME 以抑制确定与 hostname 对应的规范名称。

返回值

该函数返回以下值之一

• 如果成功，则返回指向包含主机查找结果的不透明 PRAddrInfo 结构的指针。使用 PR_EnumerateAddrInfo 检查存储在此结构中的 PRNetAddr 值。当不再需要时，必须通过调用 PR_FreeAddrInfo 销毁此指针。

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