De functie DeleteIpForwardEntry2

De functie DeleteIpForwardEntry2 verwijdert een IP-routevermelding op een lokale computer.

Syntaxis

NETIOAPI_API DeleteIpForwardEntry2(
  _In_ const MIB_IPFORWARD_ROW2 *Row
);

Parameters

• rij [in]
  Een aanwijzer naar een MIB_IPFORWARD_ROW2 structuurvermelding voor een IP-routevermelding. Bij geslaagde retour wordt deze vermelding verwijderd.

Retourwaarde

DeleteIpForwardEntry2 retourneert STATUS_SUCCESS als de functie slaagt.

Als de functie mislukt, retourneert DeleteIpForwardEntry2 een van de volgende foutcodes:

Retourcode	Beschrijving
STATUS_INVALID_PARAMETER	Er is een ongeldige parameter doorgegeven aan de functie. Deze fout wordt geretourneerd als een NULL- aanwijzer wordt doorgegeven in de parameter rij, het DestinationPrefix lid van de MIB_IPFORWARD_ROW2-structuur waarnaar de parameter rij parameter niet is opgegeven, de NextHop lid van de MIB_IPFORWARD_ROW2-structuur is niet opgegeven. of zowel InterfaceLuid als InterfaceIndex leden van de MIB_IPFORWARD_ROW2-structuur zijn niet opgegeven.
STATUS_NOT_FOUND	Kan de opgegeven interface niet vinden. Deze fout wordt geretourneerd als de functie de netwerkinterface die is opgegeven door de InterfaceLuid- of InterfaceIndex lid van de MIB_IPFORWARD_ROW2 structuur waarnaar de parameter Rij verwijst, niet kan vinden.
STATUS_NOT_SUPPORTED	De aanvraag wordt niet ondersteund. Deze fout wordt geretourneerd als er geen IPv4-stack zich op de lokale computer bevindt en er een IPv4-adres is opgegeven in het adres lid van de MIB_IPFORWARD_ROW2-structuur waarnaar de parameter rij verwijst, of als er geen IPv6-stack op de lokale computer staat en er een IPv6-adres is opgegeven in het adres lid.
Overige	Gebruik de functie FormatMessage om de berichttekenreeks voor de geretourneerde fout op te halen.

Opmerkingen

De functie DeleteIpForwardEntry2 wordt gebruikt om een MIB_IPFORWARD_ROW2 structuurvermelding te verwijderen.

Bij invoer moet uw stuurprogramma de volgende leden van de MIB_IPFORWARD_ROW2-structuur initialiseren waarnaar de rij- parameter verwijst.

• DestinationPrefix-
  Ingesteld op een geldig IPv4- of IPv6-adresvoorvoegsel en -gezin.

• NextHop-
  Ingesteld op een geldig IPv4- of IPv6-adres en -gezin.

• InterfaceLuid of InterfaceIndex
  Deze leden worden gebruikt in de volgorde die eerder wordt vermeld. Dus als InterfaceLuid- is opgegeven, wordt dit lid gebruikt om de interface te bepalen. Als er geen waarde is ingesteld voor het InterfaceLuid lid (de waarde van dit lid is ingesteld op nul), wordt de InterfaceIndex lid naast het bepalen van de interface gebruikt.

Wanneer de aanroep is geslaagd, DeleteIpForwardEntry2 de IP-routevermelding verwijdert wanneer de aanroep is geslaagd.

De functie DeleteIpForwardEntry2 mislukt als de DestinationPrefix en NextHop leden van de MIB_IPFORWARD_ROW2-structuur die de parameter Row verwijst, niet overeenkomt met een bestaande IP-routevermelding op de interface die is opgegeven in de InterfaceLuid- of InterfaceIndex-leden.

Uw stuurprogramma kan de GetIpForwardTable2- functie aanroepen om de IP-routevermeldingen op een lokale computer op te sommen.

Eisen

Doelplatform	Universal
Versie	Beschikbaar in Windows Vista en latere versies van de Windows-besturingssystemen.
Rubriek	Netioapi.h (inclusief Netioapi.h)
Bibliotheek	Netio.lib
IRQL	< DISPATCH_LEVEL

Zie ook

CreateIpForwardEntry2-

GetBestRoute2-

GetIpForwardEntry2

GetIpForwardTable2-

InitializeIpForwardEntry-

MIB_IPFORWARD_ROW2

MIB_IPFORWARD_TABLE2

NotifyRouteChange2-

SetIpForwardEntry2