GetMulticastIpAddressEntry függvény

A GetMulticastIpAddressEntry függvény egy meglévő csoportos küldésű IP-cím bejegyzés adatait kéri le egy helyi számítógépen.

Szintaxis

NETIOAPI_API GetMulticastIpAddressEntry(
  _Inout_ PMIB_MULTICASTIPADDRESS_ROW Row
);

Paraméterek

• sor [be, ki]
  Egy csoportos küldésű IP-címbejegyzés MIB_MULTICASTIPADDRESS_ROW struktúrabejegyzésére mutató mutató. Sikeres visszatérés esetén ez a struktúra frissül egy meglévő csoportos küldésű IP-cím tulajdonságaival.

Visszaadott érték

GetMulticastIpAddressEntry a függvény sikeres működése esetén STATUS_SUCCESS ad vissza.

Ha a függvény meghiúsul, GetMulticastIpAddressEntry a következő hibakódok egyikét adja vissza:

Kód visszaadása	Leírás
STATUS_INVALID_PARAMETER	Érvénytelen paraméter lett átadva a függvénynek. Ez a hiba akkor jelenik meg, ha egy NULL mutatót ad át a Sor paraméterben, az CímMIB_MULTICASTIPADDRESS_ROW struktúra azon tagja, amely szerint a Sor paraméter nem érvényes csoportos IPv4- vagy IPv6-címre volt beállítva, vagy InterfaceLuid és InterfaceIndex MIB_MULTICASTIPADDRESS_ROW-struktúra tagjai nem voltak meghatározva.
STATUS_NOT_FOUND	A megadott felület nem található. Ez a hiba akkor jelenik meg, ha a függvény nem találja a InterfaceLuid vagy InterfaceIndex által megadott hálózati adaptert, annak a MIB_MULTICASTIPADDRESS_ROW struktúrának a tagja, amelyre a Sor paraméter mutat.
STATUS_NOT_SUPPORTED	A kérés nem támogatott. Ez a hiba akkor jelenik meg, ha nem található IPv4-verem a helyi számítógépen, és egy IPv4-cím van megadva a Cím MIB_MULTICASTIPADDRESS_ROW szerkezet azon tagjában, amelyre a sor paraméter mutat, vagy ha nem található IPv6-verem a helyi számítógépen, és egy IPv6-cím van megadva a Cím tagban.
Egyéb	A FormatMessage függvénnyel szerezze be a visszaadott hiba üzenetsztringét.

Megjegyzések

A GetMulticastIpAddressEntry függvény egy meglévő MIB_MULTICASTIPADDRESS_ROW struktúrabejegyzés lekérésére szolgál.

Bemenetkor az illesztőnek inicializálnia kell annak a MIB_MULTICASTIPADDRESS_ROW struktúrának a következő tagjait, amelyekre a Sor paraméter mutat.

• Cím
  Állítsa be érvényes IPv4- vagy IPv6-címre és -családra.

• InterfaceLuid vagy InterfaceIndex
  Ezeket a tagokat a korábban felsorolt sorrendben használja a rendszer. Ha tehát InterfaceLuid van megadva, ez a tag határozza meg a felületet. Ha a InterfaceLuid taghoz nem állított be értéket (ennek a tagnak az értéke nulla volt), a InterfaceIndex tagot használja a rendszer a felület meghatározásához.

Ha a hívás sikeres, GetMulticastIpAddressEntry lekéri a csoportos küldési IP-cím többi tulajdonságát, és kitölti azt a MIB_MULTICASTIPADDRESS_ROW struktúrát, amelyre a sor paraméter mutat.

Az illesztőprogram meghívhatja a GetMulticastIpAddressTable függvényt a csoportos küldésű IP-címek bejegyzéseinek számbavételéhez egy helyi számítógépen.

Követelmények

Célplatform	Univerzális
Verzió	Elérhető a Windows Vista és a Windows operációs rendszerek újabb verzióiban.
Fejléc	Netioapi.h (netioapi.h)
Könyvtár	Netio.lib
IRQL	< DISPATCH_LEVEL

Lásd még:

GetMulticastIpAddressTable

MIB_MULTICASTIPADDRESS_ROW

MIB_MULTICASTIPADDRESS_TABLE