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

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

  • Статья

Функция MprAdminInterfaceQueryUpdateResult возвращает результат последнего запроса указанному диспетчеру маршрутизатора для обновления его маршрутов для интерфейса. Дополнительные сведения см. в разделе MprAdminInterfaceUpdateRoutes.

Синтаксис

DWORD MprAdminInterfaceQueryUpdateResult(
  [in]  MPR_SERVER_HANDLE hMprServer,
  [in]  HANDLE            hInterface,
  [in]  DWORD             dwProtocolId,
  [out] LPDWORD           lpdwUpdateResult
);

Параметры

[in] hMprServer

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

[in] hInterface

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

[in] dwProtocolId

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

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

[out] lpdwUpdateResult

Указатель на переменную DWORD . Эта переменная получает результат последнего вызова MprAdminInterfaceUpdateRoutes.

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

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

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

Значение Значение
ERROR_ACCESS_DENIED
 Вызывающее приложение не имеет достаточных привилегий.
ERROR_INTERFACE_NOT_CONNECTED
 Указанный интерфейс не подключен; результат последнего обновления больше недоступен.
ERROR_INVALID_HANDLE
 Недопустимое значение hInterface .
ERROR_INVALID_PARAMETER
 Параметр lpdwUpdateResult имеет значение NULL.
ERROR_NO_SUCH_INTERFACE
 Указанный транспорт не выполняется в указанном интерфейсе.
ERROR_UNKNOWN_PROTOCOL_ID
 Значение dwProtocolId не соответствует ни одному из поддерживаемых диспетчеров маршрутизаторов.

Комментарии

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

Требования

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

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

MprAdminInterfaceCreate

MprAdminInterfaceUpdateRoutes

MprAdminServerConnect

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

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