GetMulticastIpAddressEntry işlevi

GetMulticastIpAddressEntry işlevi, yerel bilgisayardaki mevcut çok noktaya yayın IP adresi girdisine ilişkin bilgileri alır.

Sözdizimi

NETIOAPI_API GetMulticastIpAddressEntry(
  _Inout_ PMIB_MULTICASTIPADDRESS_ROW Row
);

Parametre

• Satır [in, out]
  Çok noktaya yayın IP adresi girdisi için MIB_MULTICASTIPADDRESS_ROW yapı girdisine yönelik bir işaretçi. Başarılı bir dönüşte, bu yapı mevcut çok noktaya yayın IP adresinin özellikleriyle güncelleştirilir.

Dönüş değeri

GetMulticastIpAddressEntry, işlev başarılı olursa STATUS_SUCCESS döndürür.

İşlev başarısız olursa GetMulticastIpAddressEntry aşağıdaki hata kodlarından birini döndürür:

İade kodu	Açıklama
STATUS_INVALID_PARAMETER	İşleve geçersiz bir parametre geçirildi. Satırı parametresinde bir NULL işaretçisi geçirilirse bu hata döndürülür, Satırı parametresinin işaretdiği MIB_MULTICASTIPADDRESS_ROW yapısının Adresi üyesi geçerli bir çok noktaya yayın IPv4 veya IPv6 adresine ayarlanmamış ya da MIB_MULTICASTIPADDRESS_ROW yapısının hem InterfaceLuid hem de InterfaceIndex üyeleri belirtilmemişti.
STATUS_NOT_FOUND	Belirtilen arabirim bulunamadı. İşlev, Satır parametresinin işaret ettiği MIB_MULTICASTIPADDRESS_ROW yapısının InterfaceLuid veya InterfaceIndex üyesi tarafından belirtilen ağ arabirimini bulamazsa bu hata döndürülür.
STATUS_NOT_SUPPORTED	İstek desteklenmiyor. Yerel bilgisayarda IPv4 yığını yoksa ve Satırı parametresinin işaret MIB_MULTICASTIPADDRESS_ROW yapısının Adresi üyesinde bir IPv4 adresi belirtildiyse veya yerel bilgisayarda IPv6 yığını yoksa ve Adres üyesinde bir IPv6 adresi belirtildiyse bu hata döndürülür.
Diğer	Döndürülen hatanın ileti dizesini almak için FormatMessage işlevini kullanın.

Açıklamalar

GetMulticastIpAddressEntry işlevi, var olan bir MIB_MULTICASTIPADDRESS_ROW yapısı girdisini almak için kullanılır.

Girişte, sürücünüz Satırı parametresinin işaret MIB_MULTICASTIPADDRESS_ROW yapısının aşağıdaki üyelerini başlatmalıdır.

• Adresi
  Geçerli bir IPv4 veya IPv6 adresi ve ailesi olarak ayarlayın.

• InterfaceLuid veya InterfaceIndex
  Bu üyeler daha önce listelenen sırayla kullanılır. Bu nedenle InterfaceLuid belirtilirse, arabirimi belirlemek için bu üye kullanılır. InterfaceLuid üyesi için değer ayarlanmadıysa (bu üyenin değeri sıfır olarak ayarlandı), arabirimi belirlemek için InterfaceIndex üyesi kullanılır.

Çıktıda, çağrı başarılı olduğunda GetMulticastIpAddressEntry çok noktaya yayın IP adresinin diğer özelliklerini alır ve Satırı parametresinin işaret MIB_MULTICASTIPADDRESS_ROW yapısını doldurur.

Sürücünüz GetMulticastIpAddressTable işlevini çağırarak yerel bilgisayardaki çok noktaya yayın IP adresi girdilerini numaralandırabilir.

Gereksinim -leri

Hedef platform	Evrensel
Sürüm	Windows Vista ve Windows işletim sistemlerinin sonraki sürümlerinde kullanılabilir.
Üstbilgi	Netioapi.h (Netioapi.h içerir)
Kütüphane	Netio.lib
IRQL	< DISPATCH_LEVEL

Ayrıca bkz.

GetMulticastIpAddressTable

MIB_MULTICASTIPADDRESS_ROW

MIB_MULTICASTIPADDRESS_TABLE