共用方式為


DeleteUnicastIpAddressEntry 函式

DeleteUnicastIpAddressEntry 函式會刪除本機電腦上的現有單播 IP 位址專案。

語法

NETIOAPI_API DeleteUnicastIpAddressEntry(
  _In_ const MIB_UNICASTIPADDRESS_ROW *Row
);

參數

  • [in]
    要從本機計算機刪除之現有單播IP位址專案的 MIB_UNICASTIPADDRESS_ROW 結構專案的指標。

傳回值

如果函式成功,DeleteUnicastIpAddressEntry 會傳回STATUS_SUCCESS。

如果函式失敗,DeleteUnicastIpAddressEntry 會傳回下列其中一個錯誤碼:

傳回碼 描述
STATUS_INVALID_PARAMETER

無效的參數已傳遞至函式。 如果在 Row 參數中傳遞 NULL 指標,則會傳回此錯誤。 Row 參數所指向之 MIB_UNICASTIPADDRESS_ROW 結構的 Address 成員未設定為有效的單播 IPv4 或 IPv6 位址,或未指定 InterfaceLuidInterfaceIndex MIB_UNICASTIPADDRESS_ROW 成員。

STATUS_NOT_FOUND

找不到指定的介面。 如果函式找不到由 InterfaceLuidInterfaceIndex 所指定的網路介面,則會傳回此錯誤 MIB_UNICASTIPADDRESS_ROW 結構的成員,Row 參數所指向。

STATUS_NOT_SUPPORTED

不支援要求。 如果本機計算機上沒有IPv4堆棧,且在MIB_UNICASTIPADDRESS_ROW結構MIB_UNICASTIPADDRESS_ROW 結構 成員中 指定了 IPv4 位址,則會傳回此錯誤,或者如果本機計算機上沒有 IPv6 堆棧,且 位址 成員中指定了 IPv6 位址。

其他

使用 FormatMessage 函式取得傳回錯誤的訊息字串。

言論

DeleteUnicastIpAddressEntry 函式可用來刪除本機電腦上的現有 MIB_UNICASTIPADDRESS_ROW 結構專案。

在輸入時,驅動程式必須初始化 Row 參數指向的下列MIB_UNICASTIPADDRESS_ROW結構成員。

  • 位址
    設定為有效的 IPv4 或 IPv6 單播位址和系列。

  • InterfaceLuidInterfaceIndex
    這些成員會依照稍早所列的順序使用。 因此,如果指定 InterfaceLuid,則會使用此成員來判斷介面。 如果未為 InterfaceLuid 成員設定任何值(此成員的值設定為零),則 InterfaceIndex 成員會接著用來判斷介面。

如果函式成功,則會刪除 Row 參數所代表的現有 IP 位址。

您的驅動程式可以呼叫 getUnicastIpAddressTable 函式來列舉本機電腦上的單播IP位址專案。 您的驅動程式可以呼叫 getUnicastIpAddressEntry函式來擷取特定的現有單播 IP 位址專案。

要求

目標平臺

通用

版本

可在 Windows Vista 和更新版本的 Windows作系統中使用。

頁眉

Netioapi.h (包括 Netioapi.h)

圖書館

Netio.lib

IRQL

< DISPATCH_LEVEL

另請參閱

CreateUnicastIpAddressEntry

GetUnicastIpAddressEntry

GetUnicastIpAddressTable

InitializeUnicastIpAddressEntry

MIB_UNICASTIPADDRESS_ROW

MIB_UNICASTIPADDRESS_TABLE

NotifyUnicastIpAddressChange

SetUnicastIpAddressEntry