GetPerAdapterInfo-Funktion (iphlpapi.h)

Artikel
02/28/2024

Die GetPerAdapterInfo-Funktion ruft Informationen zum Adapter ab, der der angegebenen Schnittstelle entspricht.

Syntax

IPHLPAPI_DLL_LINKAGE DWORD GetPerAdapterInfo(
  [in]  ULONG                IfIndex,
  [out] PIP_PER_ADAPTER_INFO pPerAdapterInfo,
  [in]  PULONG               pOutBufLen
);

Parameter

[in] IfIndex

Index einer Schnittstelle. Die GetPerAdapterInfo-Funktion ruft Informationen für den Adapter ab, der dieser Schnittstelle entspricht.

[out] pPerAdapterInfo

Zeiger auf eine IP_PER_ADAPTER_INFO-Struktur , die Informationen zum Adapter empfängt.

[in] pOutBufLen

Zeiger auf eine ULONG-Variable , die die Größe der IP_PER_ADAPTER_INFO-Struktur angibt. Wenn diese Größe nicht ausreicht, um die Informationen zu enthalten, füllt GetPerAdapterInfo diese Variable mit der erforderlichen Größe aus und gibt den Fehlercode ERROR_BUFFER_OVERFLOW zurück.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert ERROR_SUCCESS.

Wenn die Funktion fehlschlägt, ist der Rückgabewert einer der folgenden Fehlercodes.

Rückgabecode	Beschreibung
ERROR_BUFFER_OVERFLOW	Die durch den pOutBufLen-Parameter angegebene Puffergröße ist zu klein, um die Adapterinformationen zu speichern. Der Parameter pOutBufLen zeigt auf die erforderliche Größe.
ERROR_INVALID_PARAMETER	Der pOutBufLen-Parameter ist NULL, oder der aufrufende Prozess hat keinen Lese-/Schreibzugriff auf den Speicher, auf den pOutBufLen verweist, oder der aufrufende Prozess hat keinen Schreibzugriff auf den Speicher, auf den der pAdapterInfo-Parameter verweist.
ERROR_NOT_SUPPORTED	GetPerAdapterInfo wird vom Betriebssystem, das auf dem lokalen Computer ausgeführt wird, nicht unterstützt.
Andere	Wenn die Funktion fehlschlägt, verwenden Sie FormatMessage , um die Meldungszeichenfolge für den zurückgegebenen Fehler abzurufen.

Hinweise

Ein Adapterindex kann sich ändern, wenn der Adapter deaktiviert und dann aktiviert wird, oder unter anderen Umständen und sollte nicht als persistent betrachtet werden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	iphlpapi.h
Bibliothek	Iphlpapi.lib
DLL	Iphlpapi.dll

Weitere Informationen

Ip-Hilfsfunktionsreferenz

Startseite des IP-Hilfsprogrammes

IP_PER_ADAPTER_INFO

Freigeben über