Função CreateProxyArpEntry (iphlpapi.h)

Artigo
08/24/2023

A função CreateProxyArpEnry cria uma entrada PARP (Proxy Address Resolution Protocol) no computador local para o endereço IPv4 especificado.

Sintaxe

IPHLPAPI_DLL_LINKAGE DWORD CreateProxyArpEntry(
  [in] DWORD dwAddress,
  [in] DWORD dwMask,
  [in] DWORD dwIfIndex
);

Parâmetros

[in] dwAddress

O endereço IPv4 para o qual este computador atua como um proxy.

[in] dwMask

A máscara de sub-rede para o endereço IPv4 especificado em dwAddress.

[in] dwIfIndex

O índice da interface na qual o ARP de proxy para o endereço IPv4 identificado por dwAddress. Em outras palavras, quando uma solicitação ARP para dwAddress é recebida nessa interface, o computador local responde com o endereço físico dessa interface. Se essa interface for de um tipo que não dá suporte ao ARP, como PPP, a chamada falhará.

Valor retornado

A função retornará NO_ERROR (zero) se a função for bem-sucedida.

Se a função falhar, o valor retornado será um dos seguintes códigos de erro.

Código de retorno	Descrição
ERROR_ACCESS_DENIED	O acesso foi negado. Esse erro é retornado no Windows Vista e no Windows Server 2008 em várias condições que incluem o seguinte: o usuário não tem os privilégios administrativos necessários no computador local ou o aplicativo não está em execução em um shell aprimorado como administrador interno (administrador RunAs).
ERROR_INVALID_PARAMETER	Um parâmetro de entrada é inválido, nenhuma ação foi tomada. Esse erro será retornado se o parâmetro dwAddress for zero ou um valor inválido, um dos outros parâmetros for inválido.
ERROR_NOT_SUPPORTED	O transporte IPv4 não está configurado no computador local.
Outros	Use FormatMessage para obter a cadeia de caracteres de mensagem para o erro retornado.

Comentários

Para recuperar a tabela ARP, chame a função GetIpNetTable . Para excluir uma entrada PARP existente, chame DeleteProxyArpEntry.

No Windows Vista e posteriores, a função CreateProxyArpEnry só pode ser chamada por um usuário conectado como membro do grupo Administradores. Se CreateProxyArpEnry for chamado por um usuário que não é membro do grupo Administradores, a chamada de função falhará e ERROR_ACCESS_DENIED será retornado. Essa função também pode falhar devido ao UAC (controle de conta de usuário) no Windows Vista e posterior. Se um aplicativo que contém essa função for executado por um usuário conectado como membro do grupo Administradores diferente do Administrador interno, essa chamada falhará, a menos que o aplicativo tenha sido marcado no arquivo de manifesto com um requestedExecutionLevel definido para exigirAdministrator. Se o aplicativo no Windows Vista e posterior não tiver esse arquivo de manifesto, um usuário conectado como membro do grupo Administradores que não seja o Administrador interno deverá executar o aplicativo em um shell aprimorado como administrador interno (administrador de RunAs) para que essa função tenha êxito.

Nota Essa função executa uma operação com privilégios. Para que essa função seja executada com êxito, o chamador deve estar conectado como membro do grupo Administradores ou do grupo NetworkConfigurationOperators.

Requisitos


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