MprAdminServerGetInfo 函数 (mprapi.h)

MprAdminServerGetInfo 函数检索有关指定 RRAS 服务器的信息。

语法

DWORD MprAdminServerGetInfo(
  [in]  MPR_SERVER_HANDLE hMprServer,
  [in]  DWORD             dwLevel,
  [out] LPBYTE            *lplpbBuffer
);

参数

[in] hMprServer

要查询的路由器的句柄。 通过调用 MprAdminServerConnect 获取此句柄。

[in] dwLevel

一个 DWORD 值,该值描述在 lplpBuffer 参数中返回信息的格式。 dwLevel 的可接受值包括 0、1 和 2,如下表所示。

结构格式
0 Windows 2000 Server 或更高版本: MPR_SERVER_0
1 Windows Server 2003 或更高版本: MPR_SERVER_1
2 Windows Server 2008 或更高版本: MPR_SERVER_2

[out] lplpbBuffer

成功完成后,指向MPR_SERVER_0的指针MPR_SERVER_1
MPR_SERVER_2 结构。 dwLevel 参数指示结构的类型。 使用 MprAdminBufferFree 释放此缓冲区的内存

返回值

如果函数成功,则返回值 NO_ERROR

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

含义
ERROR_ACCESS_DENIED
调用应用程序没有足够的权限。
ERROR_INVALID_PARAMETER
lplpbBuffer 参数为 NULL
RPC_S_INVALID_BINDING
hMprServer 参数为 NULL

要求

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

另请参阅

MPR_SERVER_0

MPR_SERVER_1

MPR_SERVER_2

MprAdminBufferFree

MprAdminServerConnect

MprAdminServerSetInfo

路由器管理功能

路由器管理参考