SetIpForwardEntry (Windows CE 5.0)

Send Feedback

This function modifies an existing route in the local computer's IP routing table. It can also add a new route to the routing table.

DWORDSetIpForwardEntry(PMIB_IPFORWARDROWpRoute);

Parameters

  • pRoute
    [in] Pointer to a MIB_IPFORWARDROW structure containing the new information for the existing route. The caller must specify values for the dwForwardIfIndex, dwForwardDest, dwForwardMask, dwForwardNextHop, dwForwardPolicy, and dwForwardProto members of the structure. For more information, see Remarks.

Return Values

Returns NO_ERROR if successful. If the function fails, it returns an error code. For a complete list of error codes, see Error Values or the SDK header file Winerror.h.

Remarks

The caller should not specify a routing protocol, such as PROTO_IP_OSPF, for the dwForwardProto member of the MIB_IPFORWARDROW structure. Routing protocol identifiers are used to identify route information received through the specified routing protocol only. For example, PROTO_IP_OSPF is used to identify route information received through the OSPF routing protocol only.

The dwForwardPolicy member of the MIB_IPFORWARDROW structure is currently unused. The caller should specify zero for this member.

Requirements

OS Versions: Windows CE 3.0 and later.
Header: Iphlpapi.h.
Link Library: Iphlpapi.lib.

See Also

IP Helper Functions | CreateIpForwardEntry | DeleteIpForwardEntry | MIB_IPFORWARDROW

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.