GetPerTcpConnectionEStats

IPv4 TCP 接続の拡張統計情報を取得する。

GetPerTcpConnectionEStats Row, EstatsType, Rw, RwVersion, RwSize, Ros, RosVersion, RosSize, Rod, RodVersion, RodSize

Row : [var] IPv4 TCP 接続の MIB_TCPROW 構造体へのポインタ。
EstatsType : [int] 要求する TCP 拡張統計情報の種別。このパラメータは、呼び出しが成功したとき Rw、Rod、Ros の各パラメータに返される情報のデータと形式を決定する。Tcpestats.h ヘッダで定義される TCP_ESTATS_TYPE 列挙型の値のいずれかを指定できる。
Rw : [var] 読み取り/書き込み情報を受け取るバッファへのポインタ。必要がない場合は NULL を指定できる。
RwVersion : [int] 要求する読み取り/書き込み情報のバージョン。現在サポートされる値は 0 のみ。
RwSize : [int] Rw パラメータが指すバッファのサイズ (バイト単位)。
Ros : [var] 読み取り専用静的情報を受け取るバッファへのポインタ。必要がない場合は NULL を指定できる。
RosVersion : [int] 要求する読み取り専用静的情報のバージョン。現在サポートされる値は 0 のみ。
RosSize : [int] Ros パラメータが指すバッファのサイズ (バイト単位)。
Rod : [var] 読み取り専用動的情報を受け取るバッファへのポインタ。TCP 接続の読み取り専用動的情報を取得する必要がない場合は NULL を指定できる。
RodVersion : [int] 要求する読み取り専用動的情報のバージョン。現在サポートされる値は 0 のみ。
RodSize : [int] Rod パラメータが指すバッファのサイズ (バイト単位)。

(プラグイン / モジュール : iphlpapi.dll)

解説

IPv4 TCP 接続の拡張統計情報を取得する。

[戻り値]
関数が成功すると、戻り値は NO_ERROR である。失敗した場合は以下のエラーコードのいずれかが返される。
このドキュメントは省略されている。

[備考]
GetPerTcpConnectionEStats 関数は Windows Vista 以降で定義される。TCP
によりネットワークおよびアプリケーション両面のパフォーマンス問題を診断するための関数である。
Row に渡された IPv4 TCP 接続の拡張統計情報を取得する。取得する統計種別は EstatsType
で指定する。TcpConnectionEstatsSynOpts を除くすべての TCP_ESTATS_TYPE 値については、あらかじめ
SetPerTcpConnectionEStats で拡張統計を有効化しておく必要がある。IPv4 TCP 接続テーブルは
GetTcpTable で取得でき、MIB_TCPROW の配列を含む MIB_TCPTABLE 構造体が返される。Row には既存の
IPv4 TCP 接続エントリを渡す必要がある。現在サポートされる TCP 接続統計のバージョンは 0 のみで、RwVersion /
RosVersion / RodVersion は 0 に設定する。IPv6 の場合は
GetPerTcp6ConnectionEStats / SetPerTcp6ConnectionEStats
を参照。SetPerTcpConnectionEStats は Administrators グループメンバのみ呼び出せ、それ以外では
ERROR_ACCESS_DENIED が返る。UAC のため、組み込み Administrator 以外のメンバからは
requestedExecutionLevel = requireAdministrator
のマニフェストが必要となる。呼び出し元は返された Rw 構造体の EnableCollection が TRUE でなければ Ros /
Rod のデータを無視するべきで、FALSE の場合 Ros / Rod の内容は未定義である。

情報