通过

MprAdminInterfaceEnum 函数 (mprapi.h)

  • 项目

MprAdminInterfaceEnum 函数枚举指定服务器上的所有接口。

语法

DWORD MprAdminInterfaceEnum(
  [in]  MPR_SERVER_HANDLE hMprServer,
  [in]  DWORD             dwLevel,
  [out] LPBYTE            *lplpbBuffer,
  [in]  DWORD             dwPrefMaxLen,
  [out] LPDWORD           lpdwEntriesRead,
  [out] LPDWORD           lpdwTotalEntries,
  [in]  LPDWORD           lpdwResumeHandle
);

参数

[in] hMprServer

要对其执行此调用的路由器的句柄。 通过调用 MprAdminServerConnect 获取此句柄。

[in] dwLevel

一个 DWORD 值，该值描述 在 lplpbBuffer 参数中返回信息的格式。 必须为零。

[out] lplpbBuffer

成功完成后，指向 MPR_INTERFACE_0 结构的数组的指针。 通过调用 MprAdminBufferFree 释放此内存缓冲区。

[in] dwPrefMaxLen

指定返回数据 () 的首选最大长度（以 8 位字节为单位）。 如果此参数为 -1，则返回的缓冲区大小足以容纳所有可用信息。

[out] lpdwEntriesRead

指向 DWORD 变量的指针。 此变量接收从枚举中的当前位置枚举的接口总数。

[out] lpdwTotalEntries

指向 DWORD 变量的指针。 此变量接收可能从当前恢复位置枚举的接口总数。

[in] lpdwResumeHandle

指向 DWORD 变量的指针。 此变量指定可用于继续枚举的恢复句柄。 第一次调用时，句柄应为零，并在后续调用中保持不变。 如果返回代码ERROR_MORE_DATA则可以使用 句柄重新发出调用以检索更多数据。 如果返回时句柄为 NULL，则无法继续枚举。 对于其他类型的错误返回，此句柄无效。

此参数是可选的。 如果调用应用程序为此参数指定 NULL ，则该函数不会返回恢复句柄。

返回值

如果函数成功，则返回值NO_ERROR。

如果函数失败，则返回值为以下错误代码之一。

值 含义
ERROR_ACCESS_DENIED
 调用应用程序没有足够的权限。
ERROR_MORE_DATA
 提供了更多信息;枚举可以继续。
ERROR_NOT_ENOUGH_MEMORY
 资源不足，无法完成操作。
ERROR_NOT_SUPPORTED
 dwLevel 的值无效。

要求

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

另请参阅

MPR_INTERFACE_0

MprAdminBufferFree

MprAdminServerConnect

路由器管理功能

路由器管理参考