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

Статья
08/24/2023

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

Синтаксис

DWORD MprAdminMIBEntryGet(
  [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