InitializeIpForwardEntry 関数 (netioapi.h)
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 |