[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
Source: Microsoft Learn / Windows Win32 documentation by Microsoft and contributors. Documentation licensed CC BY 4.0. Code samples are covered by the MIT License. Converted from Markdown, with links normalized and embedded media omitted.
