Compartilhar via


Função FlushIpNetTable (iphlpapi.h)

A função FlushIpNetTable exclui todas as entradas ARP para a interface especificada da tabela ARP no computador local.

Sintaxe

IPHLPAPI_DLL_LINKAGE DWORD FlushIpNetTable(
  [in] DWORD dwIfIndex
);

Parâmetros

[in] dwIfIndex

O índice da interface para a qual excluir todas as entradas ARP.

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

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

Confira também

CreateIpNetEntry

DeleteIpNetEntry

GetIfTable

GetIpNetTable

Referência de função auxiliar de IP

Página Inicial do Auxiliar de IP