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	hRasConn パラメーターが 0、dwSubEntry パラメーターが 0、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