RasGetConnectionStatistics 函数 (ras.h)

RasGetConnectionStatistics 函数检索指定连接的累积连接统计信息。

语法

DWORD RasGetConnectionStatistics(
  [in]      HRASCONN  hRasConn,
  [in, out] RAS_STATS *lpStatistics
);

[in] hRasConn

连接的句柄。使用 RasDial 或 RasEnumConnections 获取此句柄。

[in, out] lpStatistics

指向 RAS_STATS 结构的指针，该结构在输出时接收统计信息。

输入时，将此结构的 dwSize 成员设置为 sizeof (RAS_STATS) 。

此参数不能为 NULL。

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

如果函数失败，则返回值为以下错误代码之一，或者来自路由和远程访问错误代码或 Winerror.h 的值。

值	含义
E_INVALIDARG	以下至少一项为 true：hRasConn 参数为零，lpStatistics 参数为 NULL，或者由 RAS_STATS 结构的 dwSize 成员指定的值指定了正在使用的操作系统不支持的结构版本。
ERROR_NOT_ENOUGH_MEMORY	函数无法分配足够的内存来完成操作。
其他	使用 FormatMessage 检索与返回的错误代码对应的系统错误消息。

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