Función SetIpStatistics (iphlpapi.h)
La función SetIpStatistics activa o desactiva el reenvío IP y establece el valor predeterminado de período de vida (TTL) para el equipo local.
Sintaxis
IPHLPAPI_DLL_LINKAGE DWORD SetIpStatistics(
[in] PMIB_IPSTATS pIpStats
);
Parámetros
[in] pIpStats
Puntero a una estructura de MIB_IPSTATS . El llamador debe establecer los miembros dwForwarding y dwDefaultTTL de esta estructura en los nuevos valores. Para mantener uno de los miembros en su valor actual, use MIB_USE_CURRENT_TTL o MIB_USE_CURRENT_FORWARDING.
Valor devuelto
Si la función se realiza correctamente, el valor devuelto es NO_ERROR.
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). |
|
Se pasó un parámetro no válido a la función. Este error se devuelve si se pasa un puntero NULL en el parámetro pIpStats . Este error también se devuelve si el miembro dwForwarding de la estructura MIB_IPSTATS a la que apunta el parámetro pIpStats contiene un valor distinto de MIB_IP_NOT_FORWARDING, MIB_IP_FORWARDING o MIB_USE_CURRENT_FORWARDING. |
|
Use FormatMessage para obtener la cadena de mensaje del error devuelto. |
Comentarios
Para establecer solo el TTL predeterminado, el autor de la llamada también puede usar la función SetIpTTL .
En Windows Vista y versiones posteriores, solo un usuario que ha iniciado sesión como miembro del grupo Administradores puede llamar a la función SetIpStatistics . Si un usuario llama a SetIpStatistics que no es miembro del grupo Administradores, se producirá un error en la llamada a la función y se devolverá ERROR_ACCESS_DENIED .
La función SetIpStatistics 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 carece de este archivo de manifiesto, un usuario que inició sesión como miembro del grupo Administradores que no sea el 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