DeleteAnycastIpAddressEntry, funkcja

Funkcja DeleteAnycastIpAddressEntry usuwa istniejący wpis adresu IP emisji na komputerze lokalnym.

Składnia

NETIOAPI_API DeleteAnycastIpAddressEntry(
  _In_ const MIB_ANYCASTIPADDRESS_ROW *Row
);

Parametry

• wiersza [in]
  Wskaźnik do wpisu struktury MIB_ANYCASTIPADDRESS_ROW dla istniejącego wpisu adresu IP emisji do usunięcia z komputera lokalnego.

Wartość zwracana

DeleteAnycastIpAddressEntry zwraca STATUS_SUCCESS, jeśli funkcja powiedzie się.

Jeśli funkcja zakończy się niepowodzeniem, DeleteAnycastIpAddressEntry zwraca jeden z następujących kodów błędów:

Kod powrotny	Opis
STATUS_INVALID_PARAMETER	Do funkcji przekazano nieprawidłowy parametr. Ten błąd jest zwracany, jeśli wskaźnik o wartości null jest przekazywany w parametrze wiersza, element Adres struktury MIB_ANYCASTIPADDRESS_ROW, że row wskazuje parametr nie został ustawiony na prawidłowy adres IPv4 lub IPv6 emisji pojedynczej albo oba InterfaceLuid i InterfaceIndex składowych struktury MIB_ANYCASTIPADDRESS_ROW nie zostały określone.
STATUS_NOT_FOUND	Nie można odnaleźć określonego interfejsu. Ten błąd jest zwracany, jeśli funkcja nie może odnaleźć interfejsu sieciowego określonego przez InterfaceLuid lub InterfaceIndex elementu członkowskiego struktury MIB_ANYCASTIPADDRESS_ROW wskazywanej przez parametr wiersza.
STATUS_NOT_SUPPORTED	Żądanie nie jest obsługiwane. Ten błąd jest zwracany, jeśli na komputerze lokalnym nie znajduje się stos IPv4, a adres IPv4 został określony w adres elementu członkowskiego MIB_ANYCASTIPADDRESS_ROW struktury MIB_ANYCASTIPADDRESS_ROW, do którego wskazuje wiersz lub jeśli żaden stos IPv6 nie znajduje się na komputerze lokalnym, a adres IPv6 został określony w elemencie Adres.
inne	Użyj funkcji FormatMessage, aby uzyskać ciąg komunikatu dla zwróconego błędu.

Uwagi

Funkcja DeleteAnycastIpAddressEntry służy do usuwania istniejącego wpisu struktury MIB_ANYCASTIPADDRESS_ROW na komputerze lokalnym.

W danych wejściowych sterownik musi zainicjować następujące elementy członkowskie struktury MIB_ANYCASTIPADDRESS_ROW, do których wskazuje parametr wiersza.

• adres
  Ustaw prawidłowy adres IPv4 lub adres IPv6 i rodzinę emisji pojedynczej.

• InterfaceLuid lub InterfaceIndex
  Te elementy członkowskie są używane w kolejności wymienionej wcześniej. Dlatego jeśli określono InterfaceLuid, ten element członkowski jest używany do określania interfejsu. Jeśli nie ustawiono wartości elementu członkowskiego InterfaceLuid (wartość tego elementu członkowskiego została ustawiona na zero), element członkowski InterfaceIndex jest następnie używany do określania interfejsu.

Jeśli funkcja zakończy się pomyślnie, usunięto istniejący adres IP, który reprezentuje parametr Row.

Sterownik może wywołać funkcję GetAnycastIpAddressTable w celu wyliczenia wpisów dowolnego adresu IP emisji na komputerze lokalnym. Sterownik może wywołać funkcję GetAnycastIpAddressEntry w celu pobrania określonego istniejącego wpisu adresu IP emisji.

Wymagania

Platforma docelowa	universal
Wersja	Dostępne w systemie Windows Vista i nowszych wersjach systemów operacyjnych Windows.
Nagłówek	Netioapi.h (include Netioapi.h)
Biblioteka	Netio.lib
IRQL	< DISPATCH_LEVEL

Zobacz też

CreateAnycastIpAddressEntry

GetAnycastIpAddressEntry

getAnycastIpAddressTable

MIB_ANYCASTIPADDRESS_ROW

MIB_ANYCASTIPADDRESS_TABLE