PR_EnumerateHostEnt

评估从 PR_GetHostByName 或 PR_GetHostByAddr 获取的 PRHostEnt 结构的每个可能的地址。

语法

#include <prnetdb.h>

PRIntn PR_EnumerateHostEnt(
  PRIntn enumIndex,
  const PRHostEnt *hostEnt,
  PRUint16 port,
  PRNetAddr *address);

参数

该函数具有以下参数

enumIndex

枚举的索引。要开始枚举，此参数设置为零。要继续枚举（从而从主机条目结构中获取连续的地址），应将其值设置为函数最后返回的值。当返回零时，枚举完成。

hostEnt

指向从 PR_GetHostByName 或 PR_GetHostByAddr 获取的 PRHostEnt 结构的指针。

port

要作为 PRNetAddr 结构的一部分分配的端口号。此参数未经有效性检查。

address

输入时，指向 PRNetAddr 结构的指针。输出时，如果调用的结果大于 0，则此结构由运行时填充。

返回值

该函数返回以下值之一

• 如果成功，则函数返回您应该在枚举器的下一次调用中为 enumIndex 参数指定的值。如果函数返回 0，则枚举结束。

• 如果失败，则函数返回 -1。您可以通过调用 PR_GetError 来检索失败的原因。

描述

PR_EnumerateHostEnt 是一个无状态枚举器。主要输入 PRHostEnt 结构不会被修改。