DeleteIpNetEntry2-Funktion
Die DeleteIpNetEntry2-Funktion löscht einen IP-Nachbaradresseneintrag auf einem lokalen Computer.
Syntax
NETIOAPI_API DeleteIpNetEntry2(
_In_ const MIB_IPNET_ROW2 *Row
);
Parameter
- Zeile [in]
Ein Zeiger auf einen MIB_IPNET_ROW2-Struktureintrag für einen Benachbarten IP-Adresseintrag. Bei erfolgreicher Rückgabe wird dieser Eintrag gelöscht.
Rückgabewert
DeleteIpNetEntry2 gibt STATUS_SUCCESS zurück, wenn die Funktion erfolgreich ist.
Wenn die Funktion fehlschlägt, gibt DeleteIpNetEntry2 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_IPNET_ROW2-Struktur , auf die der Row-Parameter verweist, nicht auf eine gültige Nachbar-IPv4- oder IPv6-Adresse festgelegt wurde oder die Member InterfaceLuid und InterfaceIndex der MIB_IPNET_ROW2-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_IPNET_ROW2 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 Adresselement der MIB_IPNET_ROW2-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. |
Bemerkungen
Die DeleteIpNetEntry2-Funktion wird verwendet, um einen MIB_IPNET_ROW2-Struktureintrag zu löschen.
Bei der Eingabe muss der Treiber die folgenden Member der MIB_IPNET_ROW2 Struktur initialisieren, auf die der Row-Parameter verweist.
Adresse
Legen Sie auf eine gültige Nachbar-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 der Aufruf erfolgreich ist, löscht DeleteIpNetEntry2 bei der Ausgabe die benachbarte IP-Adresse.
Ihr Treiber kann die GetIpNetTable2-Funktion aufrufen, um die Benachbarten IP-Adresseinträge auf einem lokalen Computer aufzulisten.
Anforderungen
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 |