Enumerates each of the possible network addresses of a PRAddrInfo structure, acquired from PR_GetAddrInfoByName.

Syntax

#include <prnetdb.h>

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

Parameters

The function has the following parameters:

enumPtr

The index pointer of the enumeration. To begin an enumeration, this argument is set to NULL. To continue an enumeration (thereby getting successive addresses from the PRAddrInfo structure), the value should be set to the function's last returned value. The enumeration is complete when a value of NULL is returned.

addrInfo

A pointer to a PRAddrInfo structure returned by PR_GetAddrInfoByName.

port

The port number to be assigned as part of the PRNetAddr structure. This parameter is not checked for validity.

result

On input, a pointer to a PRNetAddr structure. On output, this structure is filled in by the runtime if the result of the call is not NULL.

Returns

The function returns the value you should specify in the enumPtr parameter for the next call of the enumerator. If the function returns NULL, the enumeration is ended.

Description

PR_EnumerateAddrInfo is a stateless enumerator. The principle input, the PRAddrInfo structure, is not modified.