GetPerAdapterInfo-Funktion (iphlpapi.h)

  • Artikel

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