SetIpNetEntry2 函式

SetIpNetEntry2 函式會設定本機計算機上現有鄰近 IP 位址項目的實體位址。

語法

NETIOAPI_API SetIpNetEntry2(
  _In_ PMIB_IPNET_ROW2 Row
);

如果函式成功，SetIpNetEntry2 會傳回STATUS_SUCCESS。

如果函式失敗，SetIpNetEntry2 會傳回下列其中一個錯誤碼：

傳回碼	描述
STATUS_INVALID_PARAMETER	無效的參數已傳遞至函式。在下列情況下，會傳回此錯誤。 NULL 指標是在 Row 參數中傳遞的。 AddressMIB_IPNET_ROW2 結構的成員，Row 參數所指向的成員未設定為有效的單播、任何廣播或多播 IPv4 或 IPv6 位址。 PhysicalAddress 和 PhysicalAddressLength MIB_IPNET_ROW2 結構的成員未設定為有效的實體位址。未指定MIB_IPNET_ROW2結構的 InterfaceLuid 和 InterfaceIndex 成員。回送位址已傳入位址成員。
STATUS_NOT_FOUND	找不到指定的介面。如果函式找不到 InterfaceLuid 或 InterfaceIndex 所指定的網路介面，Row 參數所指向之MIB_IPNET_ROW2結構的成員，就會傳回此錯誤。
STATUS_NOT_SUPPORTED	不支援要求。如果本機計算機上沒有 IPv4 堆棧，且位址成員中指定了 IPv4 位址，MIB_IPNET_ROW2結構列參數所指向的 IPv4 位址，或如果本機計算機上沒有 IPv6 堆棧，且已在 Address 成員中指定 IPv6 位址，則會傳回此錯誤。
其他	使用 FormatMessage 函式取得傳回錯誤的訊息字串。

您的驅動程式必須初始化 Row 參數指向的下列 MIB_IPNET_ROW2 結構成員。

位址
設定為有效的單播、任何廣播或多播 IPv4 或 IPv6 位址和系列。
PhysicalAddress 和 PhysicalAddressLength
設定為有效的實體位址。
InterfaceLuid 或 InterfaceIndex
這些成員會依照稍早所列的順序使用。因此，如果指定 InterfaceLuid，則會使用此成員來判斷介面。如果未為 InterfaceLuid 成員設定任何值（此成員的值設定為零），則 InterfaceIndex 成員會接著用來判斷介面。

SetIpNetEntry2 函式會失敗，如果傳入位址 MIB_IPNET_ROW2 結構成員的 IP 位址，Row 參數所指向的 IP 位址不是指定的介面上現有的鄰近 IP 位址。

目標平臺	通用
版本	可在 Windows Vista 和更新版本的 Windows作系統中使用。
頁眉	Netioapi.h （包括 Netioapi.h）
圖書館	Netio.lib
IRQL	< DISPATCH_LEVEL