Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
De functie DeleteUnicastIpAddressEntry verwijdert een bestaande unicast-IP-adresvermelding op een lokale computer.
Syntaxis
NETIOAPI_API DeleteUnicastIpAddressEntry(
_In_ const MIB_UNICASTIPADDRESS_ROW *Row
);
Parameters
-
rij [in]
Een aanwijzer naar een MIB_UNICASTIPADDRESS_ROW structuurvermelding voor een bestaande unicast-IP-adresvermelding die moet worden verwijderd van de lokale computer.
Retourwaarde
DeleteUnicastIpAddressEntry- retourneert STATUS_SUCCESS als de functie slaagt.
Als de functie mislukt, retourneert DeleteUnicastIpAddressEntry 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 adres lid van de MIB_UNICASTIPADDRESS_ROW structuur waarnaar de parameter rij verwijst, niet is ingesteld op een geldig IPv4- of IPv6-adres van unicast, of zowel InterfaceLuid als InterfaceIndex leden van de MIB_UNICASTIPADDRESS_ROW 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 niet kan vinden lid van de MIB_UNICASTIPADDRESS_ROW-structuur waarnaar de parameter Rij verwijst. |
| 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_UNICASTIPADDRESS_ROW-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 DeleteUnicastIpAddressEntry wordt gebruikt om een bestaande MIB_UNICASTIPADDRESS_ROW structuurvermelding op de lokale computer te verwijderen.
Bij invoer moet uw stuurprogramma de volgende leden van de MIB_UNICASTIPADDRESS_ROW-structuur initialiseren waarnaar de parameter rij verwijst.
adres
Ingesteld op een geldig IPv4- of IPv6-unicastadres 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.
Als de functie is geslaagd, wordt het bestaande IP-adres dat de parameter rij vertegenwoordigt, verwijderd.
Uw stuurprogramma kan de GetUnicastIpAddressTable- functie aanroepen om de vermeldingen van het unicast-IP-adres op een lokale computer op te sommen. Uw stuurprogramma kan de GetUnicastIpAddressEntry functie aanroepen om een specifieke bestaande unicast-IP-adresvermelding op te halen.
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 |