Функция 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.
Если функция завершается сбоем, возвращаемое значение представляет собой один из следующих кодов ошибок.
| Значение | Значение |
|---|---|
|
Вызывающее приложение не имеет достаточных привилегий. |
|
Недопустимое значение hInterface или значение , если указанный интерфейс отключен с правами администратора. |
|
Указанный транспорт не выполняется в указанном интерфейсе. |
|
Недостаточно ресурсов для завершения операции. |
|
Значение dwTransportId не соответствует ни одному поддерживаемому транспорту. |
Требования
| Минимальная версия клиента | Ни одна версия не поддерживается |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | mprapi.h |
| Библиотека | Mprapi.lib |
| DLL | Mprapi.dll |
См. также раздел
MprAdminInterfaceTransportSetInfo