estructura MIB_TCP6ROW2 (tcpmib.h)

Artículo
08/26/2023

La estructura MIB_TCP6ROW2 contiene información que describe una conexión TCP IPv6.

Sintaxis

typedef struct _MIB_TCP6ROW2 {
  IN6_ADDR                     LocalAddr;
  DWORD                        dwLocalScopeId;
  DWORD                        dwLocalPort;
  IN6_ADDR                     RemoteAddr;
  DWORD                        dwRemoteScopeId;
  DWORD                        dwRemotePort;
  MIB_TCP_STATE                State;
  DWORD                        dwOwningPid;
  TCP_CONNECTION_OFFLOAD_STATE dwOffloadState;
} MIB_TCP6ROW2, *PMIB_TCP6ROW2;

Miembros

LocalAddr

Tipo: IN6_ADDR

La dirección IPv6 local de 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.

dwLocalScopeId

Tipo: DWORD

Identificador de ámbito local para la conexión TCP en el equipo local.

dwLocalPort

Tipo: DWORD

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

El tamaño máximo de un número de puerto IP es de 16 bits, por lo que solo se deben usar los 16 bits inferiores. Los 16 bits superiores pueden contener datos sin inicializar.

RemoteAddr

Tipo: IN6_ADDR

La dirección IPv6 de la conexión TCP en el equipo remoto. Cuando el miembro de estado es MIB_TCP_STATE_LISTEN, este valor no tiene ningún significado.

dwRemoteScopeId

Tipo: DWORD

Identificador de ámbito remoto para la conexión TCP en el equipo remoto. Cuando el miembro de estado es MIB_TCP_STATE_LISTEN, este valor no tiene ningún 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 de estado es MIB_TCP_STATE_LISTEN, este valor no tiene ningún significado.

El tamaño máximo de un número de puerto IP es de 16 bits, por lo que solo se deben usar los 16 bits inferiores. Los 16 bits superiores pueden contener datos sin inicializar.

State

Tipo: MIB_TCP_STATE

Estado de la conexión TCP. Este miembro puede ser uno de los valores del tipo de enumeración MIB_TCP_STATE definido en el archivo de encabezado Tcpmib.h .

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 confirmación de solicitud de conexión 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-1 en espera de 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 el 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 de eliminación de TCB que representa la eliminación del bloque de control de transmisión (TCB), una estructura de datos que se usa para mantener información sobre cada entrada TCP.

dwOwningPid

Tipo: DWORD

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

dwOffloadState

Tipo: TCP_CONNECTION_OFFLOAD_STATE

Estado de descarga de esta conexión TCP. Este parámetro puede ser uno de los valores de enumeración del TCP_CONNECTION_OFFLOAD_STATE definido en el encabezado Tcpmib.h .

Comentarios

La estructura MIB_TCP6ROW2 se define en Windows Vista y versiones posteriores.

La función GetTcp6Table2 recupera la tabla de conexión TCP IPv6 en el equipo local y devuelve esta información en una estructura de MIB_TCP6TABLE2 .

Una matriz de estructuras de MIB_TCP6ROW2 se encuentra en la estructura MIB_TCP6TABLE2 .

El miembro State 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 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 , es posible que se necesiten las funciones ntohs o inet_ntoa en Windows Sockets o funciones similares.

Los miembros dwLocalScopeId y dwRemoteScopeId están en orden de bytes de red. Para usar los miembros dwLocalScopeId o dwRemoteScopeId , es posible que se necesiten las funciones ntohl o inet_ntoa en Windows Sockets o funciones similares.

Los miembros LocalAddr y RemoteAddr se almacenan en estructuras in6_addr . Las funciones RtlIpv6AddressToString o RtlIpv6AddressToStringEx se pueden usar para convertir la dirección IPv6 en los miembros LocalAddr o RemoteAddr en una cadena sin cargar el archivo DLL de Windows Sockets.

Requisitos


Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Encabezado	tcpmib.h (incluya Iphlpapi.h)