Aracılığıyla paylaş


DeleteUnicastIpAddressEntry işlevi

DeleteUnicastIpAddressEntry işlevi, yerel bilgisayardaki mevcut bir tek noktaya yayın IP adresi girdisini siler.

Sözdizimi

NETIOAPI_API DeleteUnicastIpAddressEntry(
  _In_ const MIB_UNICASTIPADDRESS_ROW *Row
);

Parametre

  • Satır [in]
    Yerel bilgisayardan silinecek mevcut bir tek noktaya yayın IP adresi girişi için MIB_UNICASTIPADDRESS_ROW yapı girdisine yönelik bir işaretçi.

Dönüş değeri

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

İşlev başarısız olursa DeleteUnicastIpAddressEntry 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_UNICASTIPADDRESS_ROW yapısının Adresi üyesi geçerli bir tek noktaya yayın IPv4 veya IPv6 adresine ayarlanmamış ya da MIB_UNICASTIPADDRESS_ROW yapısının InterfaceLuid ve InterfaceIndex üyeleri belirtilmemişti.

STATUS_NOT_FOUND

Belirtilen arabirim bulunamadı. İşlev, Satırı parametresinin işaret ettiği MIB_UNICASTIPADDRESS_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_UNICASTIPADDRESS_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

DeleteUnicastIpAddressEntry işlevi, yerel bilgisayardaki mevcut bir MIB_UNICASTIPADDRESS_ROW yapısı girdisini silmek için kullanılır.

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

  • Adresi
    Geçerli bir IPv4 veya IPv6 tek noktaya yayın 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.

İşlev başarılı olursa, Satır parametresinin temsil ettiği mevcut IP adresi silinir.

Sürücünüz, yerel bilgisayardaki tek noktaya yayın IP adresi girdilerini listelemek için GetUnicastIpAddressTable işlevini çağırabilir. Sürücünüz, belirli bir tek noktaya yayın IP adresi girdisini almak için GetUnicastIpAddressEntry işlevini çağı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.

CreateUnicastIpAddressEntry

GetUnicastIpAddressEntry

GetUnicastIpAddressTable

InitializeUnicastIpAddressEntry

MIB_UNICASTIPADDRESS_ROW

MIB_UNICASTIPADDRESS_TABLE

NotifyUnicastIpAddressChange

SetUnicastIpAddressEntry