CreateIpNetEntry2 函式
CreateIpNetEntry2 函式會在本機電腦上建立新的鄰近 IP 位址專案。
語法
NETIOAPI_API CreateIpNetEntry2(
_In_ const MIB_IPNET_ROW2 *Row
);
參數
-
列 [in]
IP 路由專案的 MIB_IPNET_ROW2 結構專案的指標。
傳回值
如果函式成功，CreateIpNetEntry2 會傳回STATUS_SUCCESS。
如果函式失敗，CreateIpNetEntry2 會傳回下列其中一個錯誤碼：
| 傳回碼 | 描述 |
|---|---|
| STATUS_INVALID_PARAMETER | 無效的參數已傳遞至函式。 如果發生下列其中一個專案，則會傳回此錯誤：
|
| STATUS_NOT_FOUND | 找不到指定的介面。 如果函式找不到 InterfaceLuid 或 InterfaceIndex 所指定的網路介面，Row 參數所指向之MIB_IPNET_ROW2結構的成員，就會傳回此錯誤。 |
| STATUS_NOT_SUPPORTED | 不支援要求。 如果本機計算機上沒有IPv4堆棧，且 位址 成員中指定了 IPv4 位址，數據列 參數點的MIB_IPNET_ROW2成員中指定了 IPv4 位址，或者如果本機計算機上沒有 IPv6 堆棧，且已在 Address 成員中指定 IPv6 位址，則會傳回此錯誤。 |
| ERROR_OBJECT_ALREADY_EXISTS | 物件已經存在。 如果 數據列 參數指向的MIB_IPNET_ROW2結構 成員 位址是 InterfaceLuid 或 InterfaceIndex MIB_IPNET_ROW2 成員所指定的介面上現有鄰近 IP 位址重複，就會傳回此錯誤。 |
| 其他 | 使用 FormatMessage 函式取得傳回錯誤的訊息字串。 |
言論
您的驅動程式必須初始化 MIB_IPNET_ROW2 結構的下列成員，Row 參數所指向：
將 位址 成員設定為有效的單播、任何廣播或多播 IPv4 或 IPv6 位址和系列。
將 PhysicalAddress 和 PhysicalAddressLength MIB_IPNET_ROW2 結構中的成員設定為有效的實體位址。
將 interfaceLuid 或 InterfaceIndex 設定為介面的 LUID 或索引值。
InterfaceLuid 和 InterfaceIndex 成員會依照先前所列的順序使用。 因此，如果指定 InterfaceLuid，這個成員會用來判斷要新增單播 IP 位址的介面。 如果未為 InterfaceLuid 成員設定任何值（此成員的值設定為零），則 InterfaceIndex 成員會接著用來判斷介面。
如果傳入 位址MIB_IPNET_ROW2結構MIB_IPNET_ROW2成員的IP 位址，則 CreateIpNetEntry2 函式會失敗，Row 參數指向的IP位址是介面上現有鄰近IP位址的重複專案。
要求
目標平臺 |
通用 |
版本 |
可在 Windows Vista 和更新版本的 Windows作系統中使用。 |
頁眉 |
Netioapi.h （包括 Netioapi.h） |
圖書館 |
Netio.lib |
IRQL |
< DISPATCH_LEVEL |