[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 RtmGetNetworkCount function retrieves the number of networks to which the routing table manager has routes.
Syntax
ULONG RtmGetNetworkCount(
_In_ DWORD ProtocolFamily
);
Parameters
ProtocolFamily [in]
Specifies for which type of network to obtain route information, for example, IP or IPX.
Return value
If the function succeeds, the return value is the network count, the number of networks known to the routing protocols of the specified protocol family.
If the return value is zero, either no routes are available, or the operation failed. Call GetLastError to obtain more information.
| Value | Description |
|---|---|
| NO_ERROR | The operation succeeded, but no routes are available. |
| ERROR_INVALID_PARAMETER | The value of the ProtocolFamily parameter does not correspond to any installed protocol family. |
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
RTMv1 Protocol Family Identifiers
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.
