DeleteAnycastIpAddressEntry 函式
DeleteAnycastIpAddressEntry函式會刪除本機電腦上的現有任何播 IP 位址專案。
語法
NETIOAPI_API DeleteAnycastIpAddressEntry(
_In_ const MIB_ANYCASTIPADDRESS_ROW *Row
);
參數
- 資料列 [in]
要從本機電腦刪除之現有 anycast IP 位址專案的 MIB_ANYCASTIPADDRESS_ROW 結構專案指標。
傳回值
如果函式成功，DeleteAnycastIpAddressEntry會傳回STATUS_SUCCESS。
如果函式失敗， DeleteAnycastIpAddressEntry 會傳回下列其中一個錯誤碼：
| 傳回碼 | 描述 |
|---|---|
| STATUS_INVALID_PARAMETER | 不正確參數已傳遞至 函式。 如果在Row參數中傳遞Null指標、Row 參數所指向之MIB_ANYCASTIPADDRESS_ROW結構的Address成員未設定為有效的單播 IPv4 或 IPv6 位址，或是未指定MIB_ANYCASTIPADDRESS_ROW結構的InterfaceLuid和InterfaceIndex成員，就會傳回此錯誤。 |
| STATUS_NOT_FOUND | 找不到指定的介面。 如果函式找不到Row參數所指向之 MIB_ANYCASTIPADDRESS_ROW 結構的InterfaceLuid或InterfaceIndex成員所指定的網路介面，就會傳回這個錯誤。 |
| STATUS_NOT_SUPPORTED | 不支援此要求。 如果本機電腦上沒有 IPv4 堆疊，而且在Row參數所指向之MIB_ANYCASTIPADDRESS_ROW結構的Address成員中指定了 IPv4 位址，或者如果本機電腦上沒有 IPv6 堆疊，且位址成員中指定了 IPv6 位址，就會傳回此錯誤。 |
| 其他 | 使用 FormatMessage 函式來取得傳回錯誤的訊息字串。 |
備註
DeleteAnycastIpAddressEntry函式可用來刪除本機電腦上的現有MIB_ANYCASTIPADDRESS_ROW結構專案。
在輸入時，驅動程式必須初始化 Row 參數指向 的下列MIB_ANYCASTIPADDRESS_ROW結構成員。
位址
設定為有效的單播 IPv4 或 IPv6 位址和系列。InterfaceLuid 或 InterfaceIndex
這些成員會依照稍早所列的順序使用。 因此，如果指定 InterfaceLuid ，則會使用此成員來判斷介面。 如果 InterfaceLuid 成員未設定任何值， (此成員的值設定為零) ，則 Next 會使用 InterfaceIndex 成員來判斷介面。
如果函式成功， 則會刪除 Row 參數所代表的現有 IP 位址。
您的驅動程式可以呼叫 GetAnycastIpAddressTable 函式，以列舉本機電腦上的 anycast IP 位址專案。 您的驅動程式可以呼叫 GetAnycastIpAddressEntry 函式，以擷取特定的現有任何播 IP 位址專案。
規格需求
目標平台 |
普遍 |
版本 |
可在 Windows Vista 和更新版本的 Windows 作業系統中使用。 |
標頭 |
Netioapi.h (包括 Netioapi.h) |
程式庫 |
Netio.lib |
IRQL |
< DISPATCH_LEVEL |