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	资源不足，无法完成操作。

注解

请勿为 lpInEntry 参数传入 NULL，因为生成的行为未定义。

要求

要求	值
最低受支持的客户端	无受支持的版本
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
目标平台	Windows
标头	mprapi.h
Library	Mprapi.lib
DLL	Mprapi.dll