Función CreateProxyArpEntry (iphlpapi.h)
La función CreateProxyArpEnry crea una entrada del Protocolo de resolución de direcciones proxy (PARP) en el equipo local para la dirección IPv4 especificada.
Sintaxis
IPHLPAPI_DLL_LINKAGE DWORD CreateProxyArpEntry(
[in] DWORD dwAddress,
[in] DWORD dwMask,
[in] DWORD dwIfIndex
);
Parámetros
[in] dwAddress
Dirección IPv4 para la que este equipo actúa como proxy.
[in] dwMask
Máscara de subred para la dirección IPv4 especificada en dwAddress.
[in] dwIfIndex
Índice de la interfaz en la que se va a proxy ARP para la dirección IPv4 identificada por dwAddress. En otras palabras, cuando se recibe una solicitud ARP para dwAddress en esta interfaz, el equipo local responde con la dirección física de esta interfaz. Si esta interfaz es de un tipo que no admite ARP, como PPP, se produce un error en la llamada.
Valor devuelto
La función devuelve NO_ERROR (cero) si la función se realiza correctamente.
Si se produce un error en la función, el valor devuelto es uno de los siguientes códigos de error.
| Código devuelto | Descripción |
|---|---|
|
Se denegó el acceso. Este error se devuelve en Windows Vista y Windows Server 2008 en varias condiciones que incluyen lo siguiente: el usuario carece de los privilegios administrativos necesarios en el equipo local o la aplicación no se ejecuta en un shell mejorado como administrador integrado (administrador de RunAs). |
|
Un parámetro de entrada no es válido, no se realizó ninguna acción. Este error se devuelve si el parámetro dwAddress es cero o un valor no válido, uno de los otros parámetros no es válido. |
|
El transporte IPv4 no está configurado en el equipo local. |
|
Use FormatMessage para obtener la cadena de mensaje del error devuelto. |
Comentarios
Para recuperar la tabla ARP, llame a la función GetIpNetTable . Para eliminar una entrada PARP existente, llame a DeleteProxyArpEntry.
En Windows Vista y versiones posteriores, la función CreateProxyArpEnry solo puede llamarla un usuario que ha iniciado sesión como miembro del grupo Administradores. Si un usuario llama a CreateProxyArpEnry que no es miembro del grupo Administradores, se producirá un error en la llamada a la función y se devolverá ERROR_ACCESS_DENIED . Esta función también puede producir un error debido al control de cuentas de usuario (UAC) en Windows Vista y versiones posteriores. Si un usuario inicia sesión como miembro del grupo Administradores que no sea el administrador integrado, esta llamada producirá un error a menos que la aplicación se haya marcado en el archivo de manifiesto con un valor requestedExecutionLevel establecido en requireAdministrator. Si la aplicación en Windows Vista y posteriormente carece de este archivo de manifiesto, un usuario que inició sesión como miembro del grupo Administradores distinto del administrador integrado debe ejecutar la aplicación en un shell mejorado como administrador integrado (administrador de runas) para que esta función se realice correctamente.
Requisitos
| Cliente mínimo compatible | Windows 2000 Professional [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows 2000 Server [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | iphlpapi.h |
| Library | Iphlpapi.lib |
| Archivo DLL | Iphlpapi.dll |
Consulte también
Referencia de la función auxiliar de IP