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 CreateIpNetEntry2 vytvoří novou položku IP adresy souseda v místním počítači.
Syntax
NETIOAPI_API CreateIpNetEntry2(
_In_ const MIB_IPNET_ROW2 *Row
);
Parametry
-
řádek [in]
Ukazatel na položku struktury MIB_IPNET_ROW2 pro položku trasy IP.
Návratová hodnota
CreateIpNetEntry2 vrátí STATUS_SUCCESS, pokud bude funkce úspěšná.
Pokud funkce selže, CreateIpNetEntry2 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 dojde k některé z následujících položek:
|
| 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_IPNET_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_IPNET_ROW2, kterou řádek body 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. |
| ERROR_OBJECT_ALREADY_EXISTS | Objekt již existuje. Tato chyba se vrátí, pokud je Adresa členem struktury MIB_IPNET_ROW2, na kterou odkazuje parametr řádek, duplikát existující IP adresy souseda v rozhraní určeném InterfaceLuid nebo InterfaceIndex člen struktury MIB_IPNET_ROW2. |
| Jiné | Pomocí funkce FormatMessage získejte řetězec zprávy pro vrácenou chybu. |
Poznámky
Ovladač musí inicializovat následující členy struktury MIB_IPNET_ROW2, na kterou řádek odkazuje:
Nastavte adresu člen na platnou jednosměrové vysílání, jakékoli vysílání nebo adresy IPv4 nebo IPv6 a řady.
Nastavte PhysicalAddress a PhysicalAddressLength členů ve struktuře MIB_IPNET_ROW2 na platnou fyzickou adresu.
Nastavte InterfaceLuid nebo InterfaceIndex na hodnotu LUID nebo index rozhraní.
Členy InterfaceLuid a InterfaceIndex se používají v uvedeném pořadí. Takže pokud InterfaceLuid je zadán, tento člen se použije k určení rozhraní pro přidání IP adresy jednosměrového vysílání. Pokud nebyla nastavena žádná hodnota pro InterfaceLuid člen (hodnota tohoto členu byla nastavena na nulu), InterfaceIndex člen se použije k určení rozhraní.
Funkce CreateIpNetEntry2 selže, pokud je IP adresa předaná v Adrese člen struktury MIB_IPNET_ROW2, na kterou odkazuje parametr řádek, je duplikát existující IP adresy souseda v rozhraní.