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	次のうち少なくとも 1 つが true です。hRasConn パラメーターが 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