Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 |
|---|---|
|
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. |
|
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. |
|
GetPerAdapterInfo wird vom Betriebssystem, das auf dem lokalen Computer ausgeführt wird, nicht unterstützt. |
|
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 |