Поделиться через


Функция RtmGetNextHopPointer (rtmv2.h)

Функция RtmGetNextHopPointer получает прямой указатель на указанный следующий прыжок. Указатель предоставляет владельцу следующего прыжка прямой доступ на чтение к структуре RTM_NEXTHOP_INFO диспетчера таблиц маршрутизации.

Синтаксис

DWORD RtmGetNextHopPointer(
  [in]  RTM_ENTITY_HANDLE  RtmRegHandle,
  [in]  RTM_NEXTHOP_HANDLE NextHopHandle,
  [out] PRTM_NEXTHOP_INFO  *NextHopPointer
);

Параметры

[in] RtmRegHandle

Дескриптор клиента, полученного из предыдущего вызова RtmRegisterEntity.

[in] NextHopHandle

Дескриптор до следующего прыжка.

[out] NextHopPointer

Если клиент является владельцем следующего прыжка, NextHopPointer получает указатель на следующий прыжок.

Возвращаемое значение

Если функция выполняется успешно, возвращаемое значение будет NO_ERROR.

Если функция завершается сбоем, возвращаемое значение представляет собой один из следующих кодов ошибок.

Значение Значение
ERROR_ACCESS_DENIED
Вызывающий клиент не владеет этим следующим прыжком.
ERROR_INVALID_HANDLE
Дескриптор недействителен.
 
 

Комментарии

Клиенты должны использовать этот указатель только для доступа только для чтения.

Если дескриптор следующего прыжка больше не требуется, отпустите его, вызвав RtmReleaseNextHopInfo.

Требования

Требование Значение
Минимальная версия клиента Ни одна версия не поддерживается
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header rtmv2.h
Библиотека Rtm.lib
DLL Rtm.dll

См. также раздел

RTM_NEXTHOP_INFO

RtmAddNextHop

RtmDeleteNextHop

RtmFindNextHop

RtmLockNextHop