MprAdminMIBEntryGetFirst 函数 (mprapi.h)

项目
03/13/2024

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

注解

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

要求

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