InitializeIpInterfaceEntry-Funktion (netioapi.h)

Artikel
02/29/2024

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

Syntax

IPHLPAPI_DLL_LINKAGE VOID NETIOAPI_API_ InitializeIpInterfaceEntry(
  [in, out] PMIB_IPINTERFACE_ROW Row
);

Parameter

[in, out] Row

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

Diese Funktion gibt keinen Wert zurück.

Bemerkungen

Die InitializeIpInterfaceEntry-Funktion wird unter Windows Vista und höher definiert.

Bei der Ausgabe wird das Family-Element in der MIB_IPINTERFACE_ROW Struktur initialisiert, auf die der Row-Parameterverweist, AF_UNSPEC, das InterfaceLuid-Element in der MIB_IPINTERFACE_ROW-Struktur mit einem nicht angegebenen Wert initialisiert, und andere Felder werden mit null initialisiert.

Die InitializeIpInterfaceEntry-Funktion muss verwendet werden, um die Felder eines MIB_IPINTERFACE_ROW Struktureintrags mit Standardwerten zu initialisieren. Eine Anwendung kann dann die Felder im MIB_IPINTERFACE_ROW Eintrag ändern, den sie ändern möchte, und dann die SetIpInterfaceEntry-Funktion aufrufen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	netioapi.h (include Iphlpapi.h)
Bibliothek	Iphlpapi.lib
DLL	Iphlpapi.dll