Функция 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

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

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