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


Функция MprAdminInterfaceTransportGetInfo (mprapi.h)

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

Синтаксис

DWORD MprAdminInterfaceTransportGetInfo(
  [in]            MPR_SERVER_HANDLE hMprServer,
  [in]            HANDLE            hInterface,
  [in]            DWORD             dwTransportId,
  [out]           LPBYTE            *ppInterfaceInfo,
  [out, optional] LPDWORD           lpdwInterfaceInfoSize
);

Параметры

[in] hMprServer

Дескриптор маршрутизатора, из которого извлекаются сведения. Получите этот дескриптор, вызвав MprAdminServerConnect.

[in] hInterface

Дескриптор интерфейса. Этот дескриптор получен из предыдущего вызова MprAdminInterfaceCreate.

[in] dwTransportId

Значение DWORD , описывающее транспорт, для которого запрашивается информация. Допустимые значения для dwTransportId перечислены в следующей таблице.

Значение Транспорт (семейство протоколов)
PID_ATALK Appletalk
PID_IP Протокол ИНТЕРНЕТА версии 4
PID_IPX Обмен пакетами в Интернете
PID_NBF Протокол netBIOS-кадров
PID_IPV6 Windows Server 2008 или более поздней версии: протокол INTERNET версии 6

[out] ppInterfaceInfo

Указатель на переменную указателя. Переменная указателя указывает на заголовок сведений, который получает сведения для указанного интерфейса и транспорта. Используйте функции заголовков сведений для управления заголовками информации. Освободите эту память, вызвав MprAdminBufferFree.

[out, optional] lpdwInterfaceInfoSize

Указатель на переменную DWORD . Эта переменная получает размер в байтах сведений об интерфейсе, возвращаемых с помощью параметра ppInterfaceInfo .

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

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

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

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

Значение Значение
ERROR_ACCESS_DENIED
Вызывающее приложение не имеет достаточных привилегий.
ERROR_INVALID_HANDLE
Недопустимое значение hInterface или значение , если указанный интерфейс отключен с правами администратора.
ERROR_NO_SUCH_INTERFACE
Указанный транспорт не выполняется в указанном интерфейсе.
ERROR_NOT_ENOUGH_MEMORY
Недостаточно ресурсов для завершения операции.
ERROR_UNKNOWN_PROTOCOL_ID
Значение dwTransportId не соответствует ни одному поддерживаемому транспорту.

Требования

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

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

MprAdminInterfaceCreate

MprAdminInterfaceTransportSetInfo

MprAdminServerConnect

Функции администрирования маршрутизатора

Справочник по управлению маршрутизатором