InitializeIpForwardEntry 関数 (netioapi.h)

[アーティクル]
03/05/2024

InitializeIpForwardEntry 関数は、ローカルコンピューター上の IP ルートエントリの既定値を使用して、MIB_IPFORWARD_ROW2構造体を初期化します。

構文

IPHLPAPI_DLL_LINKAGE VOID NETIOAPI_API_ InitializeIpForwardEntry(
  [out] PMIB_IPFORWARD_ROW2 Row
);

パラメーター

[out] Row

エントリ時に、IP ルートエントリの MIB_IPFORWARD_ROW2 構造体エントリへのポインター。戻り値の場合、このパラメーターが指す MIB_IPFORWARD_ROW2 構造体は、IP ルートエントリの既定値で初期化されます。

戻り値

この関数は値を返しません。

注釈

InitializeIpForwardEntry 関数は、Windows Vista 以降で定義されています。

InitializeIpForwardEntry 関数は、後で CreateIpForwardEntry2 関数で使用するために、IP ルートエントリの既定値を使用して、MIB_IPFORWARD_ROW2構造体エントリのメンバーを初期化するために使用する必要があります。

入力時に、 InitializeIpForwardEntry を初期化する新しい MIB_IPFORWARD_ROW2 構造体を渡す必要があります。

出力時に、Row パラメーターによって指されるMIB_IPFORWARD_ROW2構造体の ValidLifetime メンバーと PreferredLifetime メンバーは無限に初期化され、ループバック、AutoconfigureAddress、Publish、Immortal メンバーは TRUE に初期化されます。さらに、 SitePrefixLength、 Metric、および Protocol の各メンバーは無効な値に設定され、他のフィールドは 0 に初期化されます。

InitializeIpForwardEntry を呼び出した後、アプリケーションは変更するMIB_IPFORWARD_ROW2 エントリのメンバーを変更し、CreateIpForwardEntry2 を呼び出して新しい IP ルートエントリをローカルコンピューターに追加できます。

要件

要件	値
サポートされている最小のクライアント	Windows Vista [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	netioapi.h (Iphlpapi.h を含む)
Library	Iphlpapi.lib
[DLL]	Iphlpapi.dll