MprAdminConnectionGetInfoEx 函数 (mprapi.h)

项目
02/29/2024

MprAdminConnectionGetInfoEx 函数检索指定 RRAS 服务器上特定连接的连接信息。

语法

DWORD MprAdminConnectionGetInfoEx(
  [in]  RAS_SERVER_HANDLE  hRasServer,
  [in]  HANDLE             hRasConnection,
  [out] PRAS_CONNECTION_EX pRasConnection
);

参数

[in] hRasServer

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

[in] hRasConnection

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

[out] pRasConnection

指向 RAS_CONNECTION_EX 结构的指针，该结构包含 hRasServer 中 RRAS 服务器的连接信息。

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

返回值

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

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

值	含义
ERROR_ACCESS_DENIED	调用应用程序没有足够的权限。
ERROR_DDM_NOT_RUNNING	DDM (DDM) 的 Demand Dial Manager 未运行。
ERROR_PROC_NOT_FOUND	找不到指定的过程。
其他	来自 MprError.h、RasError.h 或 WinError.h 的错误。

注解

调用方应通过调用函数 MprAdminBufferFree 来释放 pRasConnection 指向的内存。

要求

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