estrutura MIB_TCPROW_OWNER_PID (tcpmib.h)
A estrutura MIB_TCPROW_OWNER_PID contém informações que descrevem uma conexão TCP IPv4 com endereços IPv4, portas usadas pela conexão TCP e a PID (ID de processo) específica associada à conexão.
Sintaxe
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;
Membros
dwState
Tipo: DWORD
O estado da conexão TCP. Esse membro pode ser um dos valores definidos no arquivo de cabeçalho Iprtrmib.h .
Na SDK do Windows lançada para Windows Vista e posterior, a organização dos arquivos de cabeçalho foi alterada. Esse membro pode ser um dos valores da enumeração MIB_TCP_STATE definida no arquivo de cabeçalho Tcpmib.h , não no arquivo de cabeçalho Iprtrmib.h . Observe que o arquivo de cabeçalho Tcpmib.h é incluído automaticamente em Iprtrmib.h, que é incluído automaticamente no arquivo de cabeçalho Iphlpapi.h . Os arquivos de cabeçalho Tcpmib.h e Iprtrmib.h nunca devem ser usados diretamente.
dwLocalAddr
Tipo: DWORD
O endereço IPv4 local para a conexão TCP no computador local. Um valor zero indica que o ouvinte pode aceitar uma conexão em qualquer interface.
dwLocalPort
Tipo: DWORD
O número da porta local na ordem de bytes de rede para a conexão TCP no computador local.
dwRemoteAddr
Tipo: DWORD
O endereço IPv4 para a conexão TCP no computador remoto. Quando o membro dwState é MIB_TCP_STATE_LISTEN, esse valor não tem significado.
dwRemotePort
Tipo: DWORD
O número da porta remota na ordem de bytes de rede para a conexão TCP no computador remoto. Quando o membro dwState é MIB_TCP_STATE_LISTEN, esse membro não tem significado.
dwOwningPid
Tipo: DWORD
O PID do processo que emitiu uma associação de contexto para essa conexão TCP.
Comentários
A estrutura MIB_TCPROW_OWNER_PID é retornada por uma chamada para GetExtendedTcpTable com o parâmetro TableClass definido como TCP_TABLE_OWNER_PID_LISTENER, TCP_TABLE_OWNER_PID_CONNECTIONS ou TCP_TABLE_OWNER_PID_ALL da enumeração TCP_TABLE_CLASS e o parâmetro ulAf definido como AF_INET4.
O membro dwState indica o estado da entrada TCP em um diagrama de estado TCP. Uma conexão TCP progride por meio de uma série de estados durante seu tempo de vida. Os estados são: LISTEN, SYN-SENT, SYN-RECEIVED, ESTABLISHED, FIN-WAIT-1, FIN-WAIT-2, CLOSE-WAIT, CLOSING, LAST-ACK, TIME-WAIT e o estado fictício CLOSED. O estado CLOSED é fictício porque representa o estado quando não há nenhum Bloco de Controle de Transmissão e, portanto, nenhuma conexão. O protocolo TCP é descrito em RFC 793. Para obter mais informações, consulte http://www.ietf.org/rfc/rfc793.txt.
Os membros dwLocalPort e dwRemotePort estão em ordem de byte de rede. Para usar os membros dwLocalPort ou dwRemotePort , as funções ntohs ou inet_ntoa no Windows Sockets ou funções semelhantes podem ser necessárias. Os membros dwLocalAddr e dwRemoteAddr são armazenados como um DWORD no mesmo formato que a estrutura in_addr . Para usar os membros dwLocalAddr ou dwRemoteAddr , as funções ntohl ou inet_ntoa no Windows Sockets ou funções semelhantes podem ser necessárias. No Windows Vista e posterior, as funções RtlIpv4AddressToString ou RtlIpv4AddressToStringEx podem ser usadas para converter o endereço IPv4 nos membros dwLocalAddr ou dwRemoteAddr em uma cadeia de caracteres sem carregar a DLL do Windows Sockets.
Na SDK do Windows lançada para Windows Vista e posterior, a organização dos arquivos de cabeçalho foi alterada. Essa estrutura é definida no arquivo de cabeçalho Tcpmib.h , não no arquivo de cabeçalho Iprtrmib.h . Observe que o arquivo de cabeçalho Tcpmib.h é incluído automaticamente em Iprtrmib.h, que é incluído automaticamente no arquivo de cabeçalho Iphlpapi.h . Os arquivos de cabeçalho Tcpmib.h e Iprtrmib.h nunca devem ser usados diretamente.
Requisitos
Requisito | Valor |
---|---|
Cliente mínimo com suporte | Windows Vista, Windows XP com SP2 [somente aplicativos da área de trabalho] |
Servidor mínimo com suporte | Windows Server 2008, Windows Server 2003 com SP1 [somente aplicativos da área de trabalho] |
Cabeçalho | tcpmib.h (inclua Iphlpapi.h) |