Função CreateProxyArpEntry (iphlpapi.h)
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 |
|---|---|
|
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). |
|
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. |
|
O transporte IPv4 não está configurado no computador local. |
|
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.
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
Referência de função auxiliar de IP