# PR_EnumerateAddrInfo

Enumerates each of the possible network addresses of a `PRAddrInfo`
structure, acquired from {ref}`PR_GetAddrInfoByName`.

## Syntax

```{code}
#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
  {ref}`PR_GetAddrInfoByName`.

`port`

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

`result`

: On input, a pointer to a {ref}`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

{ref}`PR_EnumerateAddrInfo` is a stateless enumerator. The principle input,
the `PRAddrInfo` structure, is not modified.