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 からの値です。
| 値 | 意味 |
|---|---|
|
hRasConn パラメーターが 0、dwSubEntry パラメーターが 0、lpStatistics パラメーターが NULL、または RAS_STATS 構造体の dwSize メンバーで指定された値が、使用中のオペレーティング システムでサポートされていない構造体のバージョンを指定します。 |
|
関数は、操作を完了するのに十分なメモリを割り当てませんでした。 |
|
FormatMessage を使用して、返されたエラー コードに対応するシステム エラー メッセージを取得します。 |
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | ras.h |
| Library | Rasapi32.lib |
| [DLL] | Rasapi32.dll |