Nuta
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować się zalogować lub zmienić katalog.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
Funkcja CreateIpNetEntry2 tworzy nowy wpis adresu IP sąsiada na komputerze lokalnym.
Składnia
NETIOAPI_API CreateIpNetEntry2(
_In_ const MIB_IPNET_ROW2 *Row
);
Parametry
-
wiersza [in]
Wskaźnik do wpisu struktury MIB_IPNET_ROW2 dla wpisu trasy IP.
Wartość zwracana
CreateIpNetEntry2 zwraca STATUS_SUCCESS, jeśli funkcja zakończy się pomyślnie.
Jeśli funkcja zakończy się niepowodzeniem, createIpNetEntry2 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 wystąpi jeden z następujących elementów:
|
| 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_IPNET_ROW2 wskazuje parametr wiersza . |
| STATUS_NOT_SUPPORTED | Żądanie nie jest obsługiwane. Ten błąd jest zwracany, jeśli żaden stos IPv4 nie znajduje się na komputerze lokalnym, a adres IPv4 został określony w adres elementu członkowskiego MIB_IPNET_ROW2 struktury, że Row punktów parametrów 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_IPNET_ROW2, do którego wskazuje parametr wiersza jest duplikatem istniejącego adresu IP sąsiada w interfejsie określonym przez InterfaceLuid lub InterfaceIndex składową struktury MIB_IPNET_ROW2. |
| 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_IPNET_ROW2, do których wskazuje parametr wiersza:
Ustaw element członkowski adresu na prawidłową emisję pojedynczą, emisję dowolną lub multiemisji IPv4 lub adres IPv6 i rodzinę.
Ustaw PhysicalAddress i PhysicalAddressLength elementów członkowskich MIB_IPNET_ROW2 w strukturze MIB_IPNET_ROW2 na prawidłowy adres fizyczny.
Ustaw InterfaceLuid lub InterfaceIndex na wartość LUID lub indeks interfejsu.
Składowe InterfaceLuid i InterfaceIndex są używane w podanej wcześniej kolejności. Dlatego jeśli określono InterfaceLuid, ten element członkowski jest używany do określenia interfejsu w celu dodania adresu IP emisji pojedynczej. 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.
Funkcja CreateIpNetEntry2 kończy się niepowodzeniem, jeśli adres IP przekazany w elemencie Address elementu członkowskiego struktury MIB_IPNET_ROW2, do którego wskazuje parametr wiersza, jest duplikatem istniejącego adresu IP sąsiada 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 |