InitializeIpInterfaceEntry, functie

Met de functie InitializeIpInterfaceEntry initialiseert u de leden van een MIB_IPINTERFACE_ROW structuurvermelding met standaardwaarden.

Syntaxis

VOID NETIOAPI_API_ InitializeIpInterfaceEntry(
  _Inout_ PMIB_IPINTERFACE_ROW Row
);

Parameters

• rij [in, uit]
  Een aanwijzer naar een MIB_IPINTERFACE_ROW structuur om te initialiseren. Bij geslaagde retour worden de velden in deze parameter geïnitialiseerd met standaardinformatie voor een interface op de lokale computer.

Retourwaarde

InitializeIpInterfaceEntry- retourneert STATUS_SUCCESS als de functie slaagt.

Als de functie mislukt, retourneert InitializeIpInterfaceEntry een van de volgende foutcodes:

Retourcode	Beschrijving
STATUS_INVALID_PARAMETER	Er is een ongeldige parameter doorgegeven aan de functie. Deze fout wordt geretourneerd als een NULL--aanwijzer wordt doorgegeven in de parameter rij
Overige	Gebruik de functie FormatMessage om de berichttekenreeks voor de geretourneerde fout op te halen.

Opmerkingen

In de uitvoer worden de leden van de MIB_IPINTERFACE_ROW-structuur waarnaar de rij- parameter verwijst als volgt geïnitialiseerd.

• Family-
  Ingesteld op AF_UNSPEC.

• InterfaceLuid-
  Ingesteld op een niet-opgegeven waarde.

• Alle andere leden
  Ingesteld op nul.

Uw stuurprogramma moet de functie InitializeIpInterfaceEntry gebruiken om de velden van een MIB_IPINTERFACE_ROW structuurvermelding met standaardwaarden te initialiseren. Een stuurprogramma kan vervolgens de velden in de MIB_IPINTERFACE_ROW vermelding wijzigen die het wil wijzigen en vervolgens de SetIpInterfaceEntry functie aanroepen.

Eisen

Doelplatform	Universal
Versie	Beschikbaar in Windows Vista en latere versies van de Windows-besturingssystemen.
Rubriek	Netioapi.h (inclusief Netioapi.h)
Bibliotheek	Netio.lib
IRQL	< DISPATCH_LEVEL

Zie ook

GetIpInterfaceEntry-

GetIpInterfaceTable-

MIB_IPINTERFACE_ROW

MIB_IPINTERFACE_TABLE

SetIpInterfaceEntry-