Share via


ResolveNeighbor-Funktion (iphlpapi.h)

[ResolveNeighbor ist ab Windows Vista nicht mehr verfügbar. Verwenden Sie stattdessen ResolveIpNetEntry2.]

Die ResolveNeighbor-Funktion löst die physische Adresse für einen Nachbar-IP-Adresseintrag auf dem lokalen Computer auf.

Syntax

IPHLPAPI_DLL_LINKAGE ULONG ResolveNeighbor(
  [in]      SOCKADDR *NetworkAddress,
  [out]     PVOID    PhysicalAddress,
  [in, out] PULONG   PhysicalAddressLength
);

Parameter

[in] NetworkAddress

Ein Zeiger auf eine SOCKADDR-Struktur , die den Ip-Adresseintrag und die Adressfamilie des Nachbarn enthält.

[out] PhysicalAddress

Ein Zeiger auf einen Bytearraypuffer, der die physische Adresse empfängt, die der durch den NetworkAddress-Parameter angegebenen IP-Adresse entspricht, wenn die Funktion erfolgreich ist. Die Länge des Bytearrays wird im Parameter PhysicalAddressLength übergeben.

[in, out] PhysicalAddressLength

Bei der Eingabe gibt dieser Parameter die maximale Länge des Puffers in Bytes an, der im PhysicalAddress-Parameter übergeben wird, um die physische Adresse zu empfangen. Wenn die Funktion erfolgreich ist, erhält dieser Parameter die Länge der physischen Adresse, die im Puffer zurückgegeben wird, auf den der PhysicalAddress-Parameter verweist. Wenn ERROR_BUFFER_OVERFLOW zurückgegeben wird, enthält dieser Parameter die Anzahl von Bytes, die zum Aufnehmen der physischen Adresse erforderlich sind.

Rückgabewert

Die ResolveNeighbor-Funktion schlägt immer fehl und gibt den folgenden Fehlercode zurück.

Rückgabecode Beschreibung
ERROR_NOT_SUPPORTED
Die Anforderung wird nicht unterstützt.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile iphlpapi.h
Bibliothek Iphlpapi.lib
DLL Iphlpapi.dll

Weitere Informationen

ResolveIpNetEntry2

SOCKADDR