Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This function toggles IP forwarding on or off and sets the default time-to-live (TTL) value for the local computer.

Syntax 

DWORD SetIpStatistics(
  PMIB_IPSTATS 
pIpStats 
);

Parameters

pIpStats

[in] Pointer to a MIB_IPSTATSstructure. The caller should set the dwForwardingand dwDefaultTTLmembers of this structure to the new values. To keep one of the members at its current value, use MIB_USE_CURRENT_TTL or MIB_USE_CURRENT_FORWARDING.

Return Value

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

Remarks

To set only the default TTL, the caller can also use the SetIpTTLfunction.

Requirements

Header iphlpapi.h
Library Iphlpapi.lib
Windows Embedded CE Windows CE 3.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also