RtmGetRouteAge

[This is preliminary documentation and subject to change.]

The RtmGetRouteAge function returns the age of a route. The age is the time, in seconds, since it was created or last updated.

ULONG RtmGetRouteAge(
  PVOID Route    // pointer to route structure
);
 

Parameters

Route
Pointer to a protocol-family-specific structure containing route data recently obtained from the Routing Table Manager (RTM).

Return Values

RouteAge
The time in seconds since route was created or last updated.
INFINITE
The content of the route structure is invalid. In this case, a call to GetLastError will return ERROR_INVALID_PARAMETER.

Remarks

The route age is computed from the RR_TimeStamp member of the structure pointed to by the Route parameter. The RTM sets the value of this member when a route is added or updated.

QuickInfo

  Windows NT: Use version 5.0 and later.
  Windows: Unsupported.
  Windows CE: Unsupported.
  Header: Declared in rtm.h.
  Import Library: Link with rtm.lib.

See Also

GetLastError, RTM_IP_ROUTE, RTM_IPX_ROUTE