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 GetAnycastIpAddressEntry načte informace o existující položce IP adresy vysílání v místním počítači.
Syntax
NETIOAPI_API GetAnycastIpAddressEntry(
_Inout_ PMIB_ANYCASTIPADDRESS_ROW Row
);
Parametry
-
řádek [in, out]
Ukazatel na položku struktury MIB_ANYCASTIPADDRESS_ROW pro libovolnou položku IP adresy vysílání. Po úspěšném vrácení se tato struktura aktualizuje o vlastnosti existující IP adresy libovolného vysílání.
Návratová hodnota
GetAnycastIpAddressEntry vrátí STATUS_SUCCESS, pokud je funkce úspěšná.
Pokud funkce selže, GetAnycastIpAddressEntry 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 je v parametru řádku předán ukazatel NULL, Adresa člen struktury MIB_ANYCASTIPADDRESS_ROW, na kterou odkazuje parametr řádek, nebyl nastaven na platnou adresu IPv4 nebo IPv6 vysílání, nebo InterfaceLuid i InterfaceIndex členy struktury MIB_ANYCASTIPADDRESS_ROW 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_ANYCASTIPADDRESS_ROW, 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_UNICASTIPADDRESS_ROW, na kterou odkazuje parametr řádek, nebo pokud v místním počítači není umístěna žádná adresa IPv6 a adresa IPv6 byla zadána v adresa členu. |
| Jiné | Pomocí funkce FormatMessage získejte řetězec zprávy pro vrácenou chybu. |
Poznámky
Funkce GetAnycastIpAddressEntry slouží k načtení existující položky struktury MIB_ANYCASTIPADDRESS_ROW.
Na vstupu musí ovladač inicializovat následující členy MIB_ANYCASTIPADDRESS_ROW struktury, na kterou odkazuje řádek parametru.
adresy
Nastavte platnou adresu IPv4 nebo IPv6 libovolného vysílání 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í.
Pokud je volání úspěšné, GetAnycastIpAddressEntry načte další vlastnosti pro ip adresu libovolného vysílání a vyplní MIB_ANYCASTIPADDRESS_ROW strukturu, na kterou odkazuje řádek parametru.
Ovladač může volat funkci GetAnycastIpAddressTable k vytvoření výčtu položek IP adres libovolného vysílání v místním počítači.