MprAdminConnectionGetInfo 函数 (mprapi.h)

项目
02/29/2024

MprAdminConnectionGetInfo 函数检索有关特定连接的数据。

语法

DWORD MprAdminConnectionGetInfo(
  [in]  RAS_SERVER_HANDLE hRasServer,
  [in]  DWORD             dwLevel,
  [in]  HANDLE            hRasConnection,
  [out] LPBYTE            *lplpbBuffer
);

参数

[in] hRasServer

从中检索连接信息的计算机的句柄。若要获取此句柄，请调用 MprAdminServerConnect。

[in] dwLevel

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

Windows NT 4.0：此参数必须为零。

值	结构格式
0	RAS_CONNECTION_0
1	Windows 2000 或更高版本： RAS_CONNECTION_1
2	Windows 2000 或更高版本： RAS_CONNECTION_2
3	Windows Server 2008 或更高版本： RAS_CONNECTION_3

[in] hRasConnection

要检索数据的连接的句柄。若要获取此句柄，请调用 MprAdminConnectionEnum。

[out] lplpbBuffer

成功完成后，指向描述连接的结构的数组的指针。这些结构的类型RAS_CONNECTION_0、 RAS_CONNECTION_1、 RAS_CONNECTION_2或 RAS_CONNECTION_3，具体取决于 dwLevel 参数的值。

若要释放此内存，请调用 MprAdminBufferFree。

返回值

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

如果函数失败，则返回值是下表中列出的错误代码之一。

返回代码	说明
ERROR_INVALID_PARAMETER	RAS 服务器的句柄或 RAS 连接的句柄无效。
ERROR_INVALID_LEVEL	为 dwLevel 传递的值不是零、1、2 或 3。级别 1 和 2 仅在 Windows 2000 或更高版本上受支持。级别 3 仅在 Windows Server 2008 或更高版本上受支持。
ERROR_INTERFACE_NOT_CONNECTED	hConnection 句柄无效。
RPC_S_INVALID_BINDING	hRasServer 句柄无效。
其他	来自 MprError.h、RasError.h 或 WinError.h 的错误。

注解

如果安装了 RRAS 可再发行组件，则此函数在 Windows NT 4.0 上可用。但是，RRAS 可再发行组件中包含的 Mprapi.dll 版本将函数导出为 RasAdminConnectionGetInfo ，而不是 MprAdminConnectionGetInfo。因此，使用 RRAS 可再发行组件时，请使用 LoadLibrary 和 GetProcAddress 访问此函数。

要求

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