DeleteAnycastIpAddressEntry-Funktion

Die DeleteAnycastIpAddressEntry-Funktion löscht einen vorhandenen Anycast-IP-Adresseintrag auf einem lokalen Computer.

Syntax

NETIOAPI_API DeleteAnycastIpAddressEntry(
  _In_ const MIB_ANYCASTIPADDRESS_ROW *Row
);

Zeile [in]
Ein Zeiger auf einen MIB_ANYCASTIPADDRESS_ROW-Struktureintrag für einen vorhandenen Anycast-IP-Adresseintrag, der vom lokalen Computer gelöscht werden soll.

DeleteAnycastIpAddressEntry gibt STATUS_SUCCESS zurück, wenn die Funktion erfolgreich ist.

Wenn die Funktion fehlschlägt, gibt DeleteAnycastIpAddressEntry einen der folgenden Fehlercodes zurück:

Rückgabecode	Beschreibung
STATUS_INVALID_PARAMETER	Es wurde ein ungültiger Parameter an die Funktion übergeben. Dieser Fehler wird zurückgegeben, wenn ein NULL-Zeiger im Row-Parameter übergeben wird, der Address-Member der MIB_ANYCASTIPADDRESS_ROW-Struktur , auf die der Row-Parameter verweist, nicht auf eine gültige Unicast-IPv4- oder IPv6-Adresse festgelegt wurde oder die Member InterfaceLuid und InterfaceIndex der MIB_ANYCASTIPADDRESS_ROW-Struktur nicht angegeben wurden.
STATUS_NOT_FOUND	Die angegebene Schnittstelle konnte nicht gefunden werden. Dieser Fehler wird zurückgegeben, wenn die Funktion die Netzwerkschnittstelle nicht finden kann, die vom InterfaceLuid - oder InterfaceIndex-Member der MIB_ANYCASTIPADDRESS_ROW Struktur angegeben wird, auf die der Row-Parameter verweist.
STATUS_NOT_SUPPORTED	Die Anforderung wird nicht unterstützt. Dieser Fehler wird zurückgegeben, wenn sich kein IPv4-Stapel auf dem lokalen Computer befindet und eine IPv4-Adresse im Address-Member der MIB_ANYCASTIPADDRESS_ROW-Struktur angegeben wurde, auf die der Row-Parameter verweist, oder wenn sich kein IPv6-Stapel auf dem lokalen Computer befindet und im Address-Member eine IPv6-Adresse angegeben wurde.
Andere	Verwenden Sie die FormatMessage-Funktion , um die Nachrichtenzeichenfolge für den zurückgegebenen Fehler abzurufen.

Die DeleteAnycastIpAddressEntry-Funktion wird verwendet, um einen vorhandenen MIB_ANYCASTIPADDRESS_ROW-Struktureintrag auf dem lokalen Computer zu löschen.

Bei der Eingabe muss der Treiber die folgenden Member der MIB_ANYCASTIPADDRESS_ROW Struktur initialisieren, auf die der Row-Parameter verweist.

Adresse
Legen Sie auf eine gültige Unicast-IPv4- oder IPv6-Adresse und -Familie fest.
InterfaceLuid oder InterfaceIndex
Diese Member werden in der zuvor aufgeführten Reihenfolge verwendet. Wenn Also InterfaceLuid angegeben ist, wird dieser Member verwendet, um die Schnittstelle zu bestimmen. Wenn kein Wert für das InterfaceLuid-Element festgelegt wurde (der Wert dieses Members wurde auf 0 festgelegt), wird als Nächstes das InterfaceIndex-Element verwendet, um die Schnittstelle zu bestimmen.

Wenn die Funktion erfolgreich ist, wurde die vorhandene IP-Adresse gelöscht, die der Row-Parameter darstellt.

Ihr Treiber kann die GetAnycastIpAddressTable-Funktion aufrufen, um die Anycast-IP-Adresseinträge auf einem lokalen Computer aufzulisten. Ihr Treiber kann die GetAnycastIpAddressEntry-Funktion aufrufen, um einen bestimmten vorhandenen Anycast-IP-Adresseintrag abzurufen.

Zielplattform	Universell
Version	Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme.
Header	Netioapi.h (netioapi.h einschließen)
Bibliothek	Netio.lib
IRQL	< DISPATCH_LEVEL