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