Not
Åtkomst till denna sida kräver auktorisation. Du kan prova att logga in eller byta katalog.
Åtkomst till denna sida kräver auktorisation. Du kan prova att byta katalog.
Funktionen DeleteUnicastIpAddressEntry tar bort en befintlig unicast-IP-adresspost på en lokal dator.
Syntax
NETIOAPI_API DeleteUnicastIpAddressEntry(
_In_ const MIB_UNICASTIPADDRESS_ROW *Row
);
Parametrar
-
rad [in]
En pekare till en MIB_UNICASTIPADDRESS_ROW strukturpost för en befintlig unicast-IP-adresspost som ska tas bort från den lokala datorn.
Returvärde
DeleteUnicastIpAddressEntry returnerar STATUS_SUCCESS om funktionen lyckas.
Om funktionen misslyckas returnerar DeleteUnicastIpAddressEntry någon av följande felkoder:
| Returnera kod | Beskrivning |
|---|---|
| STATUS_INVALID_PARAMETER | En ogiltig parameter skickades till funktionen. Det här felet returneras om en NULL- pekare skickas i parametern Rad. Adress medlem i den MIB_UNICASTIPADDRESS_ROW struktur som Rad parametern pekar på inte har angetts till en giltig unicast IPv4- eller IPv6-adress, eller både InterfaceLuid och InterfaceIndex medlemmar i MIB_UNICASTIPADDRESS_ROW-strukturen var ospecificerade. |
| STATUS_NOT_FOUND | Det gick inte att hitta det angivna gränssnittet. Det här felet returneras om funktionen inte kan hitta nätverksgränssnittet som anges av InterfaceLuid eller InterfaceIndex medlem i den MIB_UNICASTIPADDRESS_ROW struktur som rad parameter pekar på. |
| STATUS_NOT_SUPPORTED | Begäran stöds inte. Det här felet returneras om ingen IPv4-stack finns på den lokala datorn och en IPv4-adress angavs i adress medlem i den MIB_UNICASTIPADDRESS_ROW struktur som Rad parameter pekar på, eller om ingen IPv6-stack finns på den lokala datorn och en IPv6-adress angavs i adress medlem. |
| Andra | Använd funktionen FormatMessage för att hämta meddelandesträngen för det returnerade felet. |
Anmärkningar
Funktionen DeleteUnicastIpAddressEntry används för att ta bort en befintlig MIB_UNICASTIPADDRESS_ROW strukturpost på den lokala datorn.
Vid indata måste drivrutinen initiera följande medlemmar i den MIB_UNICASTIPADDRESS_ROW struktur som rad parametern pekar på.
adress
Ange till en giltig IPv4- eller IPv6 unicast-adress och -familj.InterfaceLuid eller InterfaceIndex
Dessa medlemmar används i den ordning som anges tidigare. Så om InterfaceLuid anges används den här medlemmen för att fastställa gränssnittet. Om inget värde har angetts för InterfaceLuid medlem (värdet för den här medlemmen har angetts till noll) används InterfaceIndex medlem för att fastställa gränssnittet.
Om funktionen lyckas tas den befintliga IP-adressen som rad parametern representerar bort.
Drivrutinen kan anropa funktionen GetUnicastIpAddressTable för att räkna upp unicast-IP-adressposterna på en lokal dator. Drivrutinen kan anropa funktionen GetUnicastIpAddressEntry för att hämta en specifik befintlig unicast-IP-adresspost.
Krav
Målplattform |
Universell |
Version |
Finns i Windows Vista och senare versioner av Windows-operativsystemen. |
Rubrik |
Netioapi.h (inkludera Netioapi.h) |
Bibliotek |
Netio.lib |
IRQL |
< DISPATCH_LEVEL |