CreateAnycastIpAddressEntry, funkcja
Funkcja CreateAnycastIpAddressEntry dodaje nowy wpis adresu IP emisji na komputerze lokalnym.
Składnia
NETIOAPI_API CreateAnycastIpAddressEntry(
_In_ const MIB_ANYCASTIPADDRESS_ROW *Row
);
Parametry
-
wiersza [in]
Wskaźnik do wpisu struktury MIB_ANYCASTIPADDRESS_ROW dla dowolnego wpisu adresu IP emisji.
Wartość zwracana
createAnycastIpAddressEntry zwraca STATUS_SUCCESS, jeśli funkcja powiedzie się.
Jeśli funkcja nie powiedzie się, createAnycastIpAddressEntry 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_UNICASTIPADDRESS_ROW, do której wskazuje 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. |
| ERROR_OBJECT_ALREADY_EXISTS | Obiekt już istnieje. Ten błąd jest zwracany, jeśli element członkowski adresu struktury MIB_ANYCASTIPADDRESS_ROW, do którego wskazuje parametr wiersza, jest duplikatem istniejącego adresu IP emisji w interfejsie określonym przez InterfaceLuid lub InterfaceIndex składowej struktury MIB_ANYCASTIPADDRESS_ROW. |
| inne | Użyj funkcji FormatMessage, aby uzyskać ciąg komunikatu dla zwróconego błędu. |
Uwagi
Sterownik musi zainicjować następujące elementy członkowskie struktury MIB_ANYCASTIPADDRESS_ROW, do których wskazuje parametr Row.
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ślenia interfejsu w celu dodania adresu IP emisji pojedynczej do. 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.
Element ScopeId struktury MIB_ANYCASTIPADDRESS_ROW, do którego wskazuje parametr wiersza, jest ignorowany, gdy wywoływana jest funkcja CreateAnycastIpAddressEntry. Element członkowski ScopeId jest automatycznie określany przez interfejs dodany przez adres.
Funkcja CreateAnycastIpAddressEntry kończy się niepowodzeniem, jeśli adres IP emisji przekazany w Adres elementu członkowskiego struktury MIB_ANYCASTIPADDRESS_ROW, do którego wskazuje parametr Row, jest duplikatem istniejącego adresu IP emisji w interfejsie.
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 |