Função ResolveNeighbor (iphlpapi.h)

[ResolveNeighbor não está mais disponível para uso a partir do Windows Vista. Em vez disso, use ResolveIpNetEntry2.]

A função ResolveNeighbor resolve o endereço físico de uma entrada de endereço IP vizinho no computador local.

Sintaxe

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

Parâmetros

[in] NetworkAddress

Um ponteiro para uma estrutura SOCKADDR que contém a entrada de endereço IP vizinho e a família de endereços.

[out] PhysicalAddress

Um ponteiro para um buffer de matriz de bytes que receberá o endereço físico que corresponde ao endereço IP especificado pelo parâmetro NetworkAddress se a função for bem-sucedida. O comprimento da matriz de bytes é passado no parâmetro PhysicalAddressLength .

[in, out] PhysicalAddressLength

Na entrada, esse parâmetro especifica o comprimento máximo, em bytes, do buffer passado no parâmetro PhysicalAddress para receber o endereço físico. Se a função for bem-sucedida, esse parâmetro receberá o comprimento do endereço físico retornado no buffer apontado pelo parâmetro PhysicalAddress . Se ERROR_BUFFER_OVERFLOW for retornado, esse parâmetro conterá o número de bytes necessários para manter o endereço físico.

Retornar valor

A função ResolveNeighbor sempre falha e retorna o código de erro a seguir.

Código de retorno	Descrição
ERROR_NOT_SUPPORTED	A solicitação não terá suporte.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	iphlpapi.h
Biblioteca	Iphlpapi.lib
DLL	Iphlpapi.dll

Confira também

ResolveIpNetEntry2

SOCKADDR