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 擷取對應至傳回之錯誤碼的系統錯誤訊息。