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