InitializeIpInterfaceEntry függvény

Az InitializeIpInterfaceEntry függvény inicializálja az alapértelmezett értékekkel rendelkező MIB_IPINTERFACE_ROW struktúrabejegyzés tagjait.

Szintaxis

VOID NETIOAPI_API_ InitializeIpInterfaceEntry(
  _Inout_ PMIB_IPINTERFACE_ROW Row
);

Paraméterek

• sor [be, ki]
  Egy inicializálandó MIB_IPINTERFACE_ROW struktúrára mutató mutató. Sikeres visszatérés esetén a paraméter mezői inicializálva lesznek a helyi számítógépen lévő felület alapértelmezett információival.

Visszaadott érték

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

Ha a függvény meghiúsul, InitializeIpInterfaceEntry 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
Egyéb	A FormatMessage függvénnyel szerezze be a visszaadott hiba üzenetsztringét.

Megjegyzések

Kimenet esetén a MIB_IPINTERFACE_ROW szerkezet azon tagjai, amelyekre a sor paraméter mutat, az alábbiak szerint lesznek inicializálva.

• Családi
  Állítsa be a AF_UNSPEC.

• InterfaceLuid
  Meg nem határozott értékre van állítva.

• Minden más tag
  Állítsa nullára.

Az illesztőprogramnak az InitializeIpInterfaceEntry függvénnyel kell inicializálnia az alapértelmezett értékekkel rendelkező MIB_IPINTERFACE_ROW struktúrabejegyzés mezőit. Az illesztő ezután módosíthatja a módosítani kívánt MIB_IPINTERFACE_ROW bejegyzés mezőit, majd meghívhatja a SetIpInterfaceEntry függvényt.

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:

GetIpInterfaceEntry

GetIpInterfaceTable

MIB_IPINTERFACE_ROW

MIB_IPINTERFACE_TABLE

SetIpInterfaceEntry