Função DeleteIpNetEntry (iphlpapi.h)

Artigo
02/28/2024

A função DeleteIpNetEntry exclui uma entrada ARP da tabela ARP no computador local.

Sintaxe

IPHLPAPI_DLL_LINKAGE DWORD DeleteIpNetEntry(
  [in] PMIB_IPNETROW pArpEntry
);

Parâmetros

[in] pArpEntry

Um ponteiro para uma estrutura MIB_IPNETROW . As informações nessa estrutura especificam a entrada a ser excluída. O chamador deve especificar valores para pelo menos os membros dwIndex e dwAddr dessa estrutura.

Retornar valor

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	Acesso 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 pArpEntry for NULL ou um membro na estrutura MIB_IPNETROW apontada pelo parâmetro pArpEntry 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 DeleteIpNetEntry só pode ser chamada por um usuário conectado como membro do grupo Administradores. Se DeleteIpNetEntry 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.

A função DeleteIpNetEntry 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 não tiver esse arquivo de manifesto, um usuário conectado como membro do grupo Administradores diferente do Administrador interno deverá executar o aplicativo em um shell aprimorado como administrador interno (administrador RunAs) para que essa função tenha êxito.

Nota No Windows NT 4.0 e windows 2000 e posterior, essa função executa uma operação privilegiada. Para que essa função seja executada com êxito, o chamador deve estar conectado como membro do grupo Administradores ou do grupo NetworkConfigurationOperators.

Requisitos

Requisito	Valor
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