Função CreateIpNetEntry (iphlpapi.h)

Artigo
08/24/2023

A função CreateIpNetEntry cria uma entrada ARP (Address Resolution Protocol) na tabela ARP no computador local.

Sintaxe

IPHLPAPI_DLL_LINKAGE DWORD CreateIpNetEntry(
  [in] PMIB_IPNETROW pArpEntry
);

Parâmetros

[in] pArpEntry

Um ponteiro para uma estrutura MIB_IPNETROW que especifica informações para a nova entrada. O chamador deve especificar valores para todos os membros dessa estrutura.

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 pArpEntry for NULL, o membro dwPhysAddrLen de MIB_IPNETROW for definido como zero ou um valor maior que 8, o >membro dwAddr da estrutura MIB_IPNETROW for inválido ou um dos outros membros da estrutura MIB_IPNETROW 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 modificar uma entrada ARP existente, use a função SetIpNetEntry . Para recuperar a tabela ARP, chame a função GetIpNetTable . Para excluir uma entrada ARP existente, chame DeleteIpNetEntry.

No Windows Vista e posteriores, a função CreateIpNetEntry só pode ser chamada por um usuário conectado como membro do grupo Administradores. Se CreateIpNetEntry 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 CreateIpNetEntry também pode falhar devido ao UAC (controle de conta de usuário) no Windows Vista posteriormente. 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 posteriores, 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


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