Função DeleteProxyArpEntry (iphlpapi.h)

Artigo
08/24/2023

A função DeleteProxyArpEntry exclui a entrada PARP no computador local especificada pelos parâmetros dwAddress e dwIfIndex .

Sintaxe

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

Parâmetros

[in] dwAddress

O endereço IPv4 para o qual este computador está atuando como um proxy.

[in] dwMask

A máscara de sub-rede para o endereço IPv4 especificado no parâmetro dwAddress .

[in] dwIfIndex

O índice da interface na qual este computador dá suporte ao proxy ARP para o endereço IP especificado pelo parâmetro dwAddress .

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.
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 .

No Windows Vista e posteriores, a função DeleteProxyArpEntry só pode ser chamada por um usuário conectado como membro do grupo Administradores. Se DeleteProxyArpEntry 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