Freigeben über


InitializeIpInterfaceEntry-Funktion

Die InitializeIpInterfaceEntry-Funktion initialisiert die Member eines MIB_IPINTERFACE_ROW Struktureintrags mit Standardwerten.

Syntax

VOID NETIOAPI_API_ InitializeIpInterfaceEntry(
  _Inout_ PMIB_IPINTERFACE_ROW Row
);

Parameter

  • Zeile [ein, aus]
    Ein Zeiger auf eine zu initialisierende MIB_IPINTERFACE_ROW Struktur. Bei erfolgreicher Rückgabe werden die Felder in diesem Parameter mit Standardinformationen für eine Schnittstelle auf dem lokalen Computer initialisiert.

Rückgabewert

InitializeIpInterfaceEntry gibt STATUS_SUCCESS zurück, wenn die Funktion erfolgreich ist.

Wenn die Funktion fehlschlägt, gibt InitializeIpInterfaceEntry einen der folgenden Fehlercodes zurück:

Rückgabecode Beschreibung
STATUS_INVALID_PARAMETER

Es wurde ein ungültiger Parameter an die Funktion übergeben. Dieser Fehler wird zurückgegeben, wenn ein NULL-Zeiger im Row-Parameter übergeben wird.

Andere

Verwenden Sie die FormatMessage-Funktion , um die Nachrichtenzeichenfolge für den zurückgegebenen Fehler abzurufen.

Bemerkungen

Bei der Ausgabe werden die Member der MIB_IPINTERFACE_ROW-Struktur , auf die der Row-Parameter verweist, wie folgt initialisiert.

  • Familie
    Legen Sie auf AF_UNSPEC fest.

  • InterfaceLuid
    Legen Sie auf einen nicht angegebenen Wert fest.

  • Alle anderen Mitglieder
    Auf NULL festlegen.

Ihr Treiber muss die InitializeIpInterfaceEntry-Funktion verwenden, um die Felder eines MIB_IPINTERFACE_ROW Struktureintrags mit Standardwerten zu initialisieren. Ein Treiber kann dann die Felder im MIB_IPINTERFACE_ROW Eintrag ändern, den er ändern möchte, und dann die SetIpInterfaceEntry-Funktion aufrufen.

Anforderungen

Zielplattform

Universell

Version

Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme.

Header

Netioapi.h (einschließlich Netioapi.h)

Bibliothek

Netio.lib

IRQL

< DISPATCH_LEVEL

Weitere Informationen

GetIpInterfaceEntry

GetIpInterfaceTable

MIB_IPINTERFACE_ROW

MIB_IPINTERFACE_TABLE

SetIpInterfaceEntry