MprAdminDeviceEnum 函数 (mprapi.h)

调用 MprAdminDeviceEnum 函数来枚举计算机上安装的可返回其名称和类型的支持 RAS 的设备。

语法

DWORD MprAdminDeviceEnum(
  [in]  MPR_SERVER_HANDLE hMprServer,
  [in]  DWORD             dwLevel,
  [out] LPBYTE            *lplpbBuffer,
  [out] LPDWORD           lpdwTotalEntries
);

参数

[in] hMprServer

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

[in] dwLevel

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

[out] lplpbBuffer

成功完成后，包含支持 RAS 的设备信息的 MPR_DEVICE_0 结构的数组。 通过调用 MprAdminBufferFree 释放此内存。

[out] lpdwTotalEntries

lpbBuffer 中MPR_DEVICE_0类型的条目数。

返回值

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

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

值	含义
ERROR_NOT_SUPPORTED	dwlevel 参数不等于零。
ERROR_INVALID_PARAMETER	lplpbBuffer 或 lpdwTotalEntries 参数为 NULL。

要求

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

另请参阅

MprAdminServerConnect

路由器管理功能

路由器管理参考