Función SetTcpEntry (iphlpapi.h)

  • Artículo

La función SetTcpEntry establece el estado de una conexión TCP.

Sintaxis

IPHLPAPI_DLL_LINKAGE DWORD SetTcpEntry(
  [in] PMIB_TCPROW pTcpRow
);

Parámetros

[in] pTcpRow

Puntero a una estructura de MIB_TCPROW . Esta estructura especifica información para identificar la conexión TCP que se va a modificar. También especifica el nuevo estado de la conexión TCP. El llamador debe especificar valores para todos los miembros de esta estructura.

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 o valor devuelto Descripción
ERROR_ACCESS_DENIED
 Acceso denegado. 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).
ERROR_INVALID_PARAMETER
 Un parámetro de entrada no es válido, no se realizó ninguna acción. Este error se devuelve si el parámetro pTcpRow es NULL o el miembro Row de la estructura MIB_TCPROW a la que apunta el parámetro pTcpRow no está establecido en MIB_TCP_STATE_DELETE_TCB.
ERROR_NOT_SUPPORTED
 El transporte IPv4 no está configurado en el equipo local.
317
 La función no puede establecer la entrada TCP, ya que la aplicación se ejecuta sin privilegios elevados.
Otros
 Use FormatMessage para obtener la cadena de mensaje del error devuelto.

Comentarios

Actualmente, el único estado en el que se puede establecer una conexión TCP es MIB_TCP_STATE_DELETE_TCB.

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 SetTcpEntry . Si un usuario llama a SetTcpEntry 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 SetTcpEntry 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

Requisito Value
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

Página de inicio del asistente de IP

MIB_TCPROW