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 函式必須用來初始化具有 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 |