GetPerTcp6ConnectionEStats

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

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

Row : [var] IPv6 TCP 接続の MIB_TCP6ROW 構造体へのポインタ。
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)

解説

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

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

[備考]
GetPerTcp6ConnectionEStats 関数は Windows Vista 以降で定義される。TCP
によりネットワークおよびアプリケーション両面のパフォーマンス問題を診断するための関数で、ネットワークベースアプリケーションの性能劣化時に、送信側・受信側・ネットワークのどこがボトルネックかを
TCP が判定し、ネットワークの場合は具体的な情報を提供できる。
Row パラメータに渡された IPv6 TCP 接続に対する拡張統計情報を取得する。取得する統計種別は EstatsType
で指定する。TcpConnectionEstatsSynOpts を除くすべての TCP_ESTATS_TYPE 値については、あらかじめ
SetPerTcp6ConnectionEStats で拡張統計を有効化しておく必要がある。IPv6 TCP 接続テーブルは
GetTcp6Table で取得でき、MIB_TCP6ROW の配列を含む MIB_TCP6TABLE 構造体が返される。Row
には既存の IPv6 TCP 接続エントリを渡す必要がある。現在サポートされる TCP 接続統計のバージョンは 0
のみで、RwVersion/RosVersion/RodVersion はすべて 0 に設定する。IPv4 接続の拡張 TCP
統計については GetPerTcpConnectionEStats / SetPerTcpConnectionEStats
を参照。SetPerTcp6ConnectionEStats は Administrators グループメンバのみが呼び出せ、それ以外では
ERROR_ACCESS_DENIED が返る。UAC の影響も受け、組み込み Administrator 以外のメンバからは
requestedExecutionLevel = requireAdministrator
のマニフェストが必要となる。呼び出し元は、返された Rw 構造体の EnableCollection フィールドを確認し、TRUE
でなければ Ros / Rod のデータを無視するべきである。EnableCollection が FALSE の場合、Ros / Rod
の内容は未定義である。例えば SetPerTcp6ConnectionEStats の呼び出しが失敗していた場合、以後の
GetPerTcp6ConnectionEStats は拡張統計ではなく無意味なランダムデータを返すことがある。

情報