Función SetIfEntry (iphlpapi.h)
La función SetIfEntry establece el estado administrativo de una interfaz.
Sintaxis
IPHLPAPI_DLL_LINKAGE DWORD SetIfEntry(
[in] PMIB_IFROW pIfRow
);
Parámetros
[in] pIfRow
Puntero a una estructura de MIB_IFROW . El miembro dwIndex de esta estructura especifica la interfaz en la que se va a establecer el estado administrativo. El miembro dwAdminStatus especifica el nuevo estado administrativo. El miembro dwAdminStatus puede ser uno de los siguientes valores.
| Valor | Significado |
|---|---|
|
La interfaz está habilitada administrativamente. |
|
La interfaz está deshabilitada administrativamente. |
Valor devuelto
Si la función se ejecuta 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 versiones posteriores 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). |
|
El sistema no encuentra el archivo especificado. Este error se devuelve en Windows Vista y versiones posteriores si no se encontró la interfaz de red especificada por el miembro dwIndex de la estructura de MIB_IFROW a la que apunta el parámetro pIfRow . |
|
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 pIfRow o el miembro dwIndex del MIB_IFROW al que apunta el parámetro pIfRow no se especificó. Este error también se devuelve en Windows Server 2003 y versiones anteriores si no se encontró la interfaz de red especificada por el miembro dwIndex de la estructura de MIB_IFROW a la que apunta el parámetro pIfRow . |
|
No se admite la solicitud. Este error se devuelve en Windows Server 2003 y versiones anteriores si no hay ninguna pila TCP/IP configurada en el equipo local. |
|
Use FormatMessage para obtener la cadena de mensaje para el error devuelto. |
Comentarios
La función SetIfEntry se usa para establecer el estado administrativo de una interfaz en un equipo local.
El miembro dwIndex de la estructura MIB_IFROW a la que apunta el parámetro pIfRow debe inicializarse en el índice de interfaz.
Se producirá un error en la función SetIfEntry si el miembro dwIndex del MIB_IFROW al que apunta el parámetro pIfRow no coincide con una interfaz existente en el equipo local.
En Windows Vista y versiones posteriores, solo un usuario puede llamar a la función SetIfEntry como miembro del grupo Administradores. Si un usuario llama a SetIfEntry que no es miembro del grupo Administradores, se producirá un error en la llamada de función y se devolverá ERROR_ACCESS_DENIED .
La función SetIfEntry también puede producir un error debido al control de cuentas de usuario (UAC) en Windows Vista y versiones posteriores. Si un usuario que ha iniciado sesión como miembro del grupo Administradores que no sea el administrador integrado ejecuta esta función, se producirá un error en esta llamada 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 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
GetIfTable
Referencia de la función auxiliar de IP