estructura MIB_TCPROW_OWNER_PID (tcpmib.h)

Artículo
08/26/2023

La estructura de MIB_TCPROW_OWNER_PID contiene información que describe una conexión TCP IPv4 con direcciones IPv4, puertos usados por la conexión TCP y el identificador de proceso específico (PID) asociado a la conexión.

Sintaxis

typedef struct _MIB_TCPROW_OWNER_PID {
  DWORD dwState;
  DWORD dwLocalAddr;
  DWORD dwLocalPort;
  DWORD dwRemoteAddr;
  DWORD dwRemotePort;
  DWORD dwOwningPid;
} MIB_TCPROW_OWNER_PID, *PMIB_TCPROW_OWNER_PID;

Miembros

dwState

Tipo: DWORD

Estado de la conexión TCP. Este miembro puede ser uno de los valores definidos en el archivo de encabezado Iprtrmib.h .

En el Windows SDK publicado para Windows Vista y versiones posteriores, la organización de archivos de encabezado ha cambiado. Este miembro puede ser uno de los valores de la enumeración MIB_TCP_STATE definida en el archivo de encabezado Tcpmib.h , no en el archivo de encabezado Iprtrmib.h . Tenga en cuenta que el archivo de encabezado Tcpmib.h se incluye automáticamente en Iprtrmib.h, que se incluye automáticamente en el archivo de encabezado Iphlpapi.h . Los archivos de encabezado Tcpmib.h e Iprtrmib.h nunca deben usarse directamente.

Valor	Significado
MIB_TCP_STATE_CLOSED 1	La conexión TCP está en estado CLOSED que no representa ningún estado de conexión.
MIB_TCP_STATE_LISTEN 2	La conexión TCP está en estado LISTEN esperando una solicitud de conexión desde cualquier PUERTO y TCP remoto.
MIB_TCP_STATE_SYN_SENT 3	La conexión TCP está en estado SYN-SENT esperando una solicitud de conexión coincidente después de haber enviado una solicitud de conexión (paquete SYN).
MIB_TCP_STATE_SYN_RCVD 4	La conexión TCP está en estado SYN-RECEIVED esperando una confirmación de solicitud de conexión confirmando después de haber recibido y enviado una solicitud de conexión (paquete SYN).
MIB_TCP_STATE_ESTAB 5	La conexión TCP está en el estado ESTABLISHED que representa una conexión abierta, los datos recibidos se pueden entregar al usuario. Este es el estado normal de la fase de transferencia de datos de la conexión TCP.
MIB_TCP_STATE_FIN_WAIT1 6	La conexión TCP es el estado FIN-WAIT-1 en espera de una solicitud de terminación de conexión desde el TCP remoto o una confirmación de la solicitud de terminación de conexión enviada anteriormente.
MIB_TCP_STATE_FIN_WAIT2 7	La conexión TCP es el estado FIN-WAIT-2 esperando una solicitud de terminación de conexión desde el TCP remoto.
MIB_TCP_STATE_CLOSE_WAIT 8	La conexión TCP está en estado CLOSE-WAIT esperando una solicitud de terminación de conexión del usuario local.
MIB_TCP_STATE_CLOSING 9	La conexión TCP está en estado CLOSING esperando una confirmación de solicitud de terminación de conexión desde el TCP remoto.
MIB_TCP_STATE_LAST_ACK 10	La conexión TCP está en el estado LAST-ACK esperando una confirmación de la solicitud de terminación de conexión enviada previamente al TCP remoto (que incluye una confirmación de su solicitud de terminación de conexión).
MIB_TCP_STATE_TIME_WAIT 11	La conexión TCP está en estado TIME-WAIT esperando suficiente tiempo para pasar para asegurarse de que el TCP remoto recibió la confirmación de su solicitud de terminación de conexión.
MIB_TCP_STATE_DELETE_TCB 12	La conexión TCP está en el estado delete TCB que representa la eliminación del bloque de control de transmisión (TCB), una estructura de datos utilizada para mantener información sobre cada entrada TCP.

dwLocalAddr

Tipo: DWORD

Dirección IPv4 local para la conexión TCP en el equipo local. Un valor de cero indica que el agente de escucha puede aceptar una conexión en cualquier interfaz.

dwLocalPort

Tipo: DWORD

Número de puerto local en orden de bytes de red para la conexión TCP en el equipo local.

dwRemoteAddr

Tipo: DWORD

Dirección IPv4 de la conexión TCP en el equipo remoto. Cuando el miembro dwState es MIB_TCP_STATE_LISTEN, este valor no tiene significado.

dwRemotePort

Tipo: DWORD

Número de puerto remoto en orden de bytes de red para la conexión TCP en el equipo remoto. Cuando el miembro dwState es MIB_TCP_STATE_LISTEN, este miembro no tiene ningún significado.

dwOwningPid

Tipo: DWORD

PID del proceso que emitió un enlace de contexto para esta conexión TCP.

Comentarios

La estructura MIB_TCPROW_OWNER_PID se devuelve mediante una llamada a GetExtendedTcpTable con el parámetro TableClass establecido en TCP_TABLE_OWNER_PID_LISTENER, TCP_TABLE_OWNER_PID_CONNECTIONS o TCP_TABLE_OWNER_PID_ALL de la enumeración TCP_TABLE_CLASS y el parámetro ulAf establecido en AF_INET4.

El miembro dwState indica el estado de la entrada TCP en un diagrama de estado TCP. Una conexión TCP avanza a través de una serie de estados durante su vigencia. Los estados son: LISTEN, SYN-SENT, SYN-RECEIVED, ESTABLISHED, FIN-WAIT-1, FIN-WAIT-2, CLOSE-WAIT, CLOSING, LAST-ACK, TIME-WAIT y el estado ficticio CLOSED. El estado CLOSED es ficticio porque representa el estado cuando no hay ningún bloque de control de transmisión y, por lo tanto, no hay ninguna conexión. El protocolo TCP se describe en RFC 793. Para obtener más información, vea http://www.ietf.org/rfc/rfc793.txt.

Los miembros dwLocalPort y dwRemotePort están en orden de bytes de red. Para usar los miembros dwLocalPort o dwRemotePort , pueden ser necesarias las funciones ntohs o inet_ntoa en Windows Sockets o funciones similares. Los miembros dwLocalAddr y dwRemoteAddr se almacenan como DWORD en el mismo formato que la estructura de in_addr . Para usar los miembros dwLocalAddr o dwRemoteAddr , es posible que se necesiten las funciones ntohl o inet_ntoa en Windows Sockets o funciones similares. En Windows Vista y versiones posteriores, las funciones RtlIpv4AddressToString o RtlIpv4AddressToStringEx se pueden usar para convertir la dirección IPv4 en los miembros dwLocalAddr o dwRemoteAddr en una cadena sin cargar el archivo DLL de Windows Sockets.

En el Windows SDK publicado para Windows Vista y versiones posteriores, la organización de archivos de encabezado ha cambiado. Esta estructura se define en el archivo de encabezado Tcpmib.h , no en el archivo de encabezado Iprtrmib.h . Tenga en cuenta que el archivo de encabezado Tcpmib.h se incluye automáticamente en Iprtrmib.h, que se incluye automáticamente en el archivo de encabezado Iphlpapi.h . Los archivos de encabezado Tcpmib.h e Iprtrmib.h nunca deben usarse directamente.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista, Windows XP con SP2 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008, Windows Server 2003 con SP1 [solo aplicaciones de escritorio]
Encabezado	tcpmib.h (incluya Iphlpapi.h)