InitializeIpForwardEntry (Compact 2013)

3/26/2014

This function initializes a MIB_IPFORWARD_ROW2 structure with default values for an IP route entry on the local device.

Syntax

VOID InitializeIpForwardEntry(
  __out  PMIB_IPFORWARD_ROW2 Row
);

Parameters

• Row
  On entry, a pointer to a MIB_IPFORWARD_ROW2 structure entry for an IP route entry. On return, the MIB_IPFORWARD_ROW2 structure pointed to by this parameter is initialized with default values for an IP route entry.

Return Value

This function does not return a value.

Remarks

The InitializeIpForwardEntry function must be used to initialize the members of a MIB_IPFORWARD_ROW2 structure entry with default values for an IP route entry for later use with the CreateIpForwardEntry2 function.

On input, InitializeIpForwardEntry must be passed a new MIB_IPFORWARD_ROW2 structure to initialize.

On output, the ValidLifetime and PreferredLifetime members of the MIB_IPFORWARD_ROW2 structure pointed to by Row parameter will be initialized to infinite and the Loopback, AutoconfigureAddress, Publish, and Immortal members will be initialized to TRUE. In addition, the SitePrefixLength, Metric, and Protocol members are set to an illegal value and other fields are initialized to zero.

After calling InitializeIpForwardEntry, an application can then change the members in the MIB_IPFORWARD_ROW2 entry it wishes to modify, and then call the CreateIpForwardEntry2 to add the new IP route entry to the local device.

See Also

Reference

IP Helper Functions
CreateIpForwardEntry2
DeleteIpForwardEntry2
GetBestRoute2
GetIpForwardEntry2
GetIpForwardTable2
MIB_IPFORWARD_ROW2
MIB_IPFORWARD_TABLE2
NotifyRouteChange2
SetIpForwardEntry2