InitializeIpForwardEntry 函式 (netioapi.h)

發行項
02/29/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 函式必須用來初始化具有 IP 路由項目預設值的MIB_IPFORWARD_ROW2結構項目成員，以便稍後搭配 CreateIpForwardEntry2 函式使用。

在輸入上， InitializeIpForwardEntry 必須傳遞新的 MIB_IPFORWARD_ROW2 結構來初始化。

輸出時，Row 參數所指向之MIB_IPFORWARD_ROW2結構的 ValidLifetime 和 PreferredLifetime 成員將會初始化為無限，且 AutoconfigureAddress、Publish 和 Immortal 成員會初始化為 TRUE。此外， SitePrefixLength、 Metric 和 Protocol 成員會設定為不合法的值，而其他字段則會初始化為零。

呼叫 InitializeIpForwardEntry 之後，應用程式就可以變更其想要修改之MIB_IPFORWARD_ROW2 專案中的成員，然後呼叫 CreateIpForwardEntry2 ，將新的 IP 路由專案新增至本機計算機。

規格需求

需求	值
最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 [僅限傳統型應用程式]
目標平台	Windows
標頭	netioapi.h (包括 Iphlpapi.h)
程式庫	Iphlpapi.lib
Dll	Iphlpapi.dll