estructura MIB_TCPROW_OWNER_MODULE (tcpmib.h)
La estructura MIB_TCPROW_OWNER_MODULE contiene información que describe una conexión TCP IPv4 con datos de propiedad, 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_MODULE {
DWORD dwState;
DWORD dwLocalAddr;
DWORD dwLocalPort;
DWORD dwRemoteAddr;
DWORD dwRemotePort;
DWORD dwOwningPid;
LARGE_INTEGER liCreateTimestamp;
ULONGLONG OwningModuleInfo[TCPIP_OWNING_MODULE_SIZE];
} MIB_TCPROW_OWNER_MODULE, *PMIB_TCPROW_OWNER_MODULE;
Miembros
dwState
Tipo: DWORD
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 los 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 se deben usar directamente.
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 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 dwState está 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.
liCreateTimestamp
Tipo: LARGE_INTEGER
Estructura FILETIME que indica cuándo se produjo la operación de enlace de contexto que creó este vínculo TCP.
OwningModuleInfo[TCPIP_OWNING_MODULE_SIZE]
Tipo: ULONGLONG[TCPIP_OWNING_MODULE_SIZE]
Matriz de datos opacos que contiene información de propiedad.
Comentarios
La estructura MIB_TCPROW_OWNER_MODULE se devuelve mediante una llamada a GetExtendedTcpTable con el parámetro TableClass establecido en TCP_TABLE_OWNER_MODULE_LISTENER, TCP_TABLE_OWNER_MODULE_CONNECTIONS o TCP_TABLE_OWNER_MODULE_ALL desde 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 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 dwLocalAddr y dwRemoteAddr se almacenan como DWORD en el mismo formato que la estructura 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 los 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 se deben usar 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) |