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

Статья
08/24/2023

Функция MprAdminMIBEntryGetNext извлекает следующую переменную из набора переменных, экспортированных диспетчером протокола или маршрутизатора. Модуль, который обслуживает вызов, определяет следующий.

Синтаксис

DWORD MprAdminMIBEntryGetNext(
  [in]  MIB_SERVER_HANDLE hMibServer,
  [in]  DWORD             dwProtocolId,
  [in]  DWORD             dwRoutingPid,
  [in]  LPVOID            lpInEntry,
  [in]  DWORD             dwInEntrySize,
  [out] LPVOID            *lplpOutEntry,
  [out] LPDWORD           lpOutEntrySize
);

Параметры

[in] hMibServer

Дескриптор маршрутизатора, на котором выполняется этот вызов. Этот дескриптор получен при предыдущем вызове MprAdminMIBServerConnect.

[in] dwProtocolId

Указывает диспетчер маршрутизатора , экспортированного переменной.

[in] dwRoutingPid

Указывает протокол маршрутизации , который экспортировал переменную.

[in] lpInEntry

Указатель на непрозрачную структуру данных. Формат структуры данных определяется модулем, который обслуживает вызов. Структура данных должна содержать сведения, указывающие запрашиваемую переменную.

[in] dwInEntrySize

Задает размер (в байтах) структуры данных, на которую указывает lpInEntry.

[out] lplpOutEntry

Указатель на переменную указателя. При успешном возвращении эта переменная указателя указывает на непрозрачную структуру данных. Формат структуры данных определяется модулем, который обслуживает вызов. Структура данных получает значение следующей переменной из экспортированного набора переменных. Освободите эту память, вызвав MprAdminMIBufferFree.

[out] lpOutEntrySize

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

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

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

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

Значение	Описание
ERROR_ACCESS_DENIED	Вызывающий объект не имеет достаточных привилегий.
ERROR_CANNOT_COMPLETE	Переменная dwRoutingPid не соответствует ни одному установленному протоколу маршрутизации.
ERROR_UNKNOWN_PROTOCOL_ID	Значение dwTransportId не соответствует ни одному установленному диспетчеру маршрутизатора.
ERROR_NOT_ENOUGH_MEMORY	Недостаточно ресурсов для завершения операции.

Требования


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