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

Статья
08/24/2023

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

Синтаксис

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