RasGetLinkStatistics 函数 (ras.h)

RasGetLinkStatistics 函数检索 RAS 多链接连接中指定链接的累积统计信息。

语法

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

[in] hRasConn

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

[in] dwSubEntry

指定与要检索统计信息的链接相对应的子项。

[in, out] lpStatistics

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

输入时，此结构的 dwSize 成员指定 RAS_STATS的大小。使用 sizeof (RAS_STATS) 获取此大小。

此参数不能为 NULL。

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

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

值	含义
E_INVALID_ARG	以下至少一项为 true：hRasConn 参数为零，dwSubEntry 参数为零，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