RtmGetEnumNextHops function (rtmv2.h)
The RtmGetEnumNextHops function retrieves the next set of next hops in the specified enumeration.
DWORD RtmGetEnumNextHops( RTM_ENTITY_HANDLE RtmRegHandle, RTM_ENUM_HANDLE EnumHandle, PUINT NumNextHops, PRTM_NEXTHOP_HANDLE NextHopHandles );
Handle to the client obtained from a previous call to RtmRegisterEntity.
Handle to the next-hop enumeration.
On input, NumNextHops is a pointer to a UINT value specifying the maximum number of next hops that can be received by NextHopHandles.
On output, NumNextHops receives the actual number of next hops received by NextHopHandles.
On input, NextHopHandles pointers to an RTM_NEXTHOP_INFO structure.
On output, NextHopHandles receives an array of handles to next hops.
If the function succeeds, the return value is NO_ERROR.
If the function fails, the return value is one of the following error codes.
||The value pointed to by NumRoutes is larger than the maximum number of routes a client is allowed to retrieve with one call. Check RTM_REGN_PROFILE for the maximum number of next hops that the client is allowed to retrieve with one call.|
||There are no more next hops to enumerate.|
When the next hops are no longer required, release them by calling RtmReleaseNextHops.
|Minimum supported client||None supported|
|Minimum supported server||Windows 2000 Server [desktop apps only]|