Redagować

Udostępnij przez


RtmGetRouteAge function

[This API has been superseded by the Routing Table Manager Version 2 API and will not be available beyond Windows Server 2003. Applications should use the Routing Table Manager Version 2 API.]

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

Syntax

ULONG RtmGetRouteAge(
  _In_ PVOID Route
);

Parameters

Route [in]

Pointer to a protocol-family-specific structure that specifies route data recently obtained from the routing table manager.

Return value

The return value is one of the following values.

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

Remarks

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

Requirements

Requirement Value
Minimum supported client
None supported
Minimum supported server
Windows 2000 Server [desktop apps only]
End of server support
Windows Server 2003
Header
Rtm.h
Library
Rtm.lib
DLL
Rtm.dll

See also

Routing Table Manager Version_1 Reference

Routing Table Manager Version 1 Functions

GetLastError

RTM_IP_ROUTE

RTM_IPX_ROUTE