The CreateIpForwardEntry function creates a route in the local computer's IP routing table.
DWORD CreateIpForwardEntry( PMIB_IPFORWARDROW pRoute // pointer to route information);
Pointer to a MIB_IPFORWARDROW structure that specifies the information for the new route. The caller must specify values for all members of this structure. The caller must specify PROTO_IP_NETMGMT for the dwForwardProto member of MIB_IPFORWARDROW.
If the function succeeds, the return value is NO_ERROR.
If the function fails, the return value is one of the following error codes.
|ERROR_INVALID_PARAMETER||The pRoute parameter is NULL, or SetIpForwardEntry is unable to read from the memory pointed to by pRoute, or one of the members of the MIB_IPFORWARDROW structure is invalid.|
|ERROR_NOT_SUPPORTED||The IP transport is not configured on the local computer.|
|Other||Use FormatMessage to obtain the message string for the returned error.|
To modify an existing route in the IP routing table, use the SetIpForwardEntry function.
The caller should not specify a routing protocol — for example, PROTO_IP_OSPF — for the dwForwardProto member of the MIB_IPFORWARDROW structure. Routing protocol identifiers are used only to identify route information received through the specified routing protocol. For example, PROTO_IP_OSPF is used only to identify route information received through the OSPF routing protocol.
The dwForwardPolicy member of the MIB_IPFORWARDROW structure is currently unused. The caller should specify zero for this member.
|Runs On||Versions||Defined in||Include||Link to|
|Windows CE OS||3.0 and later||Iphlpapi.h||Iphlpapi.lib|
Note This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.
Last updated on Tuesday, July 13, 2004
© 1992-2000 Microsoft Corporation. All rights reserved.