InitializeIpInterfaceEntry işlevi

InitializeIpInterfaceEntry işlevi, bir MIB_IPINTERFACE_ROW yapı girişinin üyelerini varsayılan değerlerle başlatır.

Sözdizimi

VOID NETIOAPI_API_ InitializeIpInterfaceEntry(
  _Inout_ PMIB_IPINTERFACE_ROW Row
);

Parametre

• Satır [in, out]
  Başlatılabilir MIB_IPINTERFACE_ROW yapısının işaretçisi. Başarılı dönüşte, bu parametredeki alanlar yerel bilgisayardaki bir arabirim için varsayılan bilgilerle başlatılır.

Dönüş değeri

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

İşlev başarısız olursa InitializeIpInterfaceEntry 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 NULL işaretçisi geçirilirse 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

Çıktıda, Satırı parametresinin işaretdiği MIB_IPINTERFACE_ROW yapısının üyeleri aşağıdaki gibi başlatılır.

• Aile
  AF_UNSPEC olarak ayarlayın.

• InterfaceLuid
  Belirtilmemiş bir değere ayarlayın.

• Diğer tüm üyeler
  Sıfır olarak ayarlayın.

Sürücünüz, MIB_IPINTERFACE_ROW yapı girdisinin alanlarını varsayılan değerlerle başlatmak için InitializeIpInterfaceEntry işlevini kullanmalıdır. Sürücü daha sonra değiştirmek istediği MIB_IPINTERFACE_ROW girdisindeki alanları değiştirebilir ve ardından SetIpInterfaceEntry 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.

GetIpInterfaceEntry

GetIpInterfaceTable

MIB_IPINTERFACE_ROW

MIB_IPINTERFACE_TABLE

SetIpInterfaceEntry