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

Функция MgmGetProtocolOnInterface (mgm.h)

  • Статья

Функция MgmGetProtocolOnInterface извлекает идентификатор протокола многоадресной маршрутизации, которому принадлежит указанный интерфейс.

Синтаксис

DWORD MgmGetProtocolOnInterface(
  [in]      DWORD  dwIfIndex,
  [in]      DWORD  dwIfNextHopAddr,
  [in, out] PDWORD pdwIfProtocolId,
  [in, out] PDWORD pdwIfComponentId
);

Параметры

[in] dwIfIndex

Указывает индекс интерфейса, для которого требуется получить идентификатор протокола.

[in] dwIfNextHopAddr

Указывает адрес следующего прыжка, который соответствует индексу, заданному dwIfIndex. Параметры dwIfIndex и dwIfNextHopIPAddr однозначно определяют следующий прыжок в интерфейсах типа "точка — многоточечная". Интерфейс типа "точка — многоточечная" — это подключение, при котором один интерфейс подключается к нескольким сетям. Примеры интерфейсов типа "точка — многоточечная" включают интерфейсы NBMA и внутренний интерфейс, к которому подключаются все клиенты с телефонным подключением.

Для широковещательных интерфейсов (таких как интерфейсы Ethernet) или интерфейсов типа "точка — точка", которые идентифицируются только по значению dwIfIndex, укажите ноль.

[in, out] pdwIfProtocolId

При входе клиент должен указать указатель на расположение памяти размера DWORD.

В выходных данных pdwIfProtocolId получает идентификатор протокола в интерфейсе, указанном dwIfIndex.

[in, out] pdwIfComponentId

При входе клиент должен указать указатель на значение DWORD .

В выходных данных pdwIfComponentId получает идентификатор компонента для экземпляра протокола в интерфейсе . Этот параметр используется с pdwIfProtocolId для уникальной идентификации экземпляра протокола маршрутизации.

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

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

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

Значение Значение
ERROR_CAN_NOT_COMPLETE
 Не удалось завершить вызов этой функции.
ERROR_NOT_FOUND
 Указанный интерфейс не найден диспетчером групп многоадресной рассылки.
 
 

Требования

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

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

MgmReleaseInterfaceOwnership

MgmTakeInterfaceOwnership