GetIpStatisticsEx 関数 (iphlpapi.h)

[アーティクル]
02/28/2024

GetIpStatisticsEx 関数は、現在のコンピューターのインターネットプロトコル (IP) 統計情報を取得します。 GetIpStatisticsEx 関数は、GetIpStatisticsEx がインターネットプロトコルバージョン 6 (IPv6) プロトコルファミリもサポートするという点で、GetIpStatistics 関数とは異なります。

構文

IPHLPAPI_DLL_LINKAGE ULONG GetIpStatisticsEx(
  [out] PMIB_IPSTATS Statistics,
  [in]  ULONG        Family
);

パラメーター

[out] Statistics

ローカルコンピューターの IP 統計情報を受け取る MIB_IPSTATS 構造体へのポインター。

[in] Family

統計を取得するプロトコルファミリ。このパラメーターは、次のいずれかの値である必要があります。

値	意味
AF_INET	インターネットプロトコルバージョン 4 (IPv4)。
AF_INET6	インターネットプロトコル Version 6 (IPv6)。

戻り値

関数が成功した場合、戻り値はNO_ERROR。

関数が失敗した場合、戻り値は次のいずれかのエラーコードになります。

リターンコード	説明
ERROR_INVALID_PARAMETER	pStats パラメーターが NULL であるか、有効なメモリを指していないか、dwFamily パラメーターが有効な値ではありません。
ERROR_NOT_SUPPORTED	この関数は、関数呼び出しが行われたオペレーティングシステムではサポートされていません。
その他	FormatMessage を使用して、返されたエラーのメッセージ文字列を取得します。

注釈

GetIpStatisticsEx を使用して、ローカルコンピューター上の IPv4 または IPv6 の IP 統計情報を取得できます。

GetIpStatistics 関数は、ローカルコンピューター上の IPv4 のみの統計を返します。

要件

要件	値
サポートされている最小のクライアント	Windows XP [デスクトップアプリ \| UWP アプリ]
サポートされている最小のサーバー	Windows Server 2003 [デスクトップアプリのみ \| UWP アプリ]
対象プラットフォーム	Windows
ヘッダー	iphlpapi.h
Library	Iphlpapi.lib
[DLL]	Iphlpapi.dll