PR_EnumerateAddrInfo

枚举从 PR_GetAddrInfoByName 获取的 PRAddrInfo 结构的每个可能的网络地址。

语法

#include <prnetdb.h>

void *PR_EnumerateAddrInfo(
  void *enumPtr,
  const PRAddrInfo *addrInfo,
  PRUint16 port,
  PRNetAddr *result);

参数

该函数具有以下参数

enumPtr

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

addrInfo

指向由 PR_GetAddrInfoByName 返回的 PRAddrInfo 结构的指针。

port

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

result

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

返回值

该函数返回您应在枚举器的下次调用中为 enumPtr 参数指定的值。如果函数返回 NULL，则枚举结束。

描述

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