Poznámka:
Přístup k této stránce vyžaduje autorizaci. Můžete se zkusit přihlásit nebo změnit adresáře.
Přístup k této stránce vyžaduje autorizaci. Můžete zkusit změnit adresáře.
Funkce DeleteIpForwardEntry2 odstraní položku trasy PROTOKOLU IP v místním počítači.
Syntax
NETIOAPI_API DeleteIpForwardEntry2(
_In_ const MIB_IPFORWARD_ROW2 *Row
);
Parametry
-
řádek [in]
Ukazatel na položku MIB_IPFORWARD_ROW2 struktury pro položku trasy IP. Po úspěšném vrácení se tato položka odstraní.
Návratová hodnota
DeleteIpForwardEntry2 vrátí STATUS_SUCCESS, pokud bude funkce úspěšná.
Pokud funkce selže, DeleteIpForwardEntry2 vrátí jeden z následujících kódů chyb:
| Návratový kód | Popis |
|---|---|
| STATUS_INVALID_PARAMETER | Funkci byla předána neplatná hodnota parametru. Tato chyba se vrátí, pokud ukazatel NULL předá parametr řádku řádku, DestinationPrefix člen struktury MIB_IPFORWARD_ROW2, ke které řádek parametr odkazuje, NextHop člen struktury MIB_IPFORWARD_ROW2 nebyl zadán. interfaceLuid i InterfaceIndex členy MIB_IPFORWARD_ROW2 struktury nebyly zadány. |
| STATUS_NOT_FOUND | Zadané rozhraní nebylo nalezeno. Tato chyba se vrátí, pokud funkce nemůže najít síťové rozhraní určené InterfaceLuid nebo InterfaceIndex člen struktury MIB_IPFORWARD_ROW2, na kterou odkazuje řádek parametru. |
| STATUS_NOT_SUPPORTED | Požadavek není podporován. Tato chyba se vrátí, pokud v místním počítači není umístěn žádný zásobník IPv4 a adresa IPv4 byla zadána v Adresa člen struktury MIB_IPFORWARD_ROW2, na kterou odkazuje parametr řádek parametr, nebo pokud se v místním počítači nenachází žádný zásobník IPv6 a adresa IPv6 byla zadána v adresa člen. |
| Jiné | Pomocí funkce FormatMessage získejte řetězec zprávy pro vrácenou chybu. |
Poznámky
Funkce DeleteIpForwardEntry2 slouží k odstranění položky struktury MIB_IPFORWARD_ROW2.
Při vstupu musí ovladač inicializovat následující členy MIB_IPFORWARD_ROW2 struktury, na kterou odkazuje řádek parametru.
DestinationPrefix
Nastavte platnou předponu adresy IPv4 nebo IPv6 a rodinu.nextHop
Nastavte platnou adresu IPv4 nebo IPv6 a rodinu.InterfaceLuid nebo InterfaceIndex
Tito členové se používají v pořadí, které je uvedeno dříve. Pokud je tedy zadán InterfaceLuid, použije se tento člen k určení rozhraní. Pokud nebyla nastavena žádná hodnota pro InterfaceLuid člen (hodnota tohoto členu byla nastavena na nulu), InterfaceIndex člen se použije k určení rozhraní.
Při úspěšném volání DeleteIpForwardEntry2 odstraní položku trasy PROTOKOLU IP.
Funkce DeleteIpForwardEntry2 selže, pokud DestinationPrefix a NextHop členy struktury MIB_IPFORWARD_ROW2, že parametr řádek odkazuje na existující položku trasy PROTOKOLU IP v rozhraní zadaném v InterfaceLuid nebo InterfaceIndex členy.
Ovladač může volat funkci GetIpForwardTable2 k vytvoření výčtu položek směrování PROTOKOLU IP na místním počítači.