estrutura MIB_TCP6ROW (tcpmib.h)
A estrutura MIB_TCP6ROW contém informações que descrevem uma conexão TCP IPv6.
Sintaxe
typedef struct _MIB_TCP6ROW {
MIB_TCP_STATE State;
IN6_ADDR LocalAddr;
DWORD dwLocalScopeId;
DWORD dwLocalPort;
IN6_ADDR RemoteAddr;
DWORD dwRemoteScopeId;
DWORD dwRemotePort;
} MIB_TCP6ROW, *PMIB_TCP6ROW;
Membros
State
Tipo: MIB_TCP_STATE
O estado da conexão TCP. Esse membro pode ser um dos valores do tipo de enumeração MIB_TCP_STATE definido no arquivo de cabeçalho Tcpmib.h .
LocalAddr
Tipo: IN6_ADDR
O endereço IPv6 local para a conexão TCP no computador local. Um valor zero indica que o ouvinte pode aceitar uma conexão em qualquer interface.
dwLocalScopeId
Tipo: DWORD
A ID de escopo local para a conexão TCP no computador local.
dwLocalPort
Tipo: DWORD
O número da porta local na ordem de bytes de rede para a conexão TCP no computador local.
O tamanho máximo de um número de porta IP é de 16 bits, portanto, somente os 16 bits inferiores devem ser usados. Os 16 bits superiores podem conter dados não inicializados.
RemoteAddr
Tipo: IN6_ADDR
O endereço IPv6 para a conexão TCP no computador remoto. Quando o membro State é MIB_TCP_STATE_LISTEN, esse valor não tem nenhum significado.
dwRemoteScopeId
Tipo: DWORD
A ID de escopo remoto para a conexão TCP no computador remoto. Quando o membro State é MIB_TCP_STATE_LISTEN, esse valor não tem nenhum 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 State é MIB_TCP_STATE_LISTEN, esse valor não tem nenhum significado.
O tamanho máximo de um número de porta IP é de 16 bits, portanto, somente os 16 bits inferiores devem ser usados. Os 16 bits superiores podem conter dados não inicializados.
Comentários
A estrutura MIB_TCP6ROW é definida no Windows Vista e posterior.
A função GetTcp6Table recupera a tabela de conexões TCP IPv6 no computador local e retorna essas informações em uma estrutura de MIB_TCP6TABLE .
Uma matriz de estruturas de MIB_TCP6ROW estão contidas na estrutura MIB_TCP6TABLE .
O membro State 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 no 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 dwLocalScopeId e dwRemoteScopeId estão em ordem de byte de rede. Para usar os membros dwLocalScopeId ou dwRemoteScopeId , as funções ntohl ou inet_ntoa no Windows Sockets ou funções semelhantes podem ser necessárias.
Os membros LocalAddr e RemoteAddr são armazenados em estruturas in6_addr . As funções RtlIpv6AddressToString ou RtlIpv6AddressToStringEx podem ser usadas para converter o endereço IPv6 nos membros LocalAddr ou RemoteAddr em uma cadeia de caracteres sem carregar a DLL do Windows Sockets.
Exemplos
O exemplo a seguir recupera a tabela de conexões TCP para IPv6 e imprime o estado de cada conexão representada como uma estrutura de MIB_TCP6ROW .
#define UNICODE 1
#include <winsock2.h>
#include <ws2tcpip.h>
#include <iphlpapi.h>
#include <stdio.h>
// Need to link with Iphlpapi.lib and Ws2_32.lib
#pragma comment(lib, "iphlpapi.lib")
#pragma comment(lib, "ws2_32.lib")
#define MALLOC(x) HeapAlloc(GetProcessHeap(), 0, (x))
#define FREE(x) HeapFree(GetProcessHeap(), 0, (x))
/* Note: could also use malloc() and free() */
int wmain()
{
// Declare and initialize variables
PMIB_TCP6TABLE pTcpTable;
DWORD dwSize = 0;
DWORD dwRetVal = 0;
wchar_t ipstringbuffer[46];
int i;
pTcpTable = (MIB_TCP6TABLE *) MALLOC(sizeof (MIB_TCP6TABLE));
if (pTcpTable == NULL) {
wprintf(L"Error allocating memory\n");
return 1;
}
dwSize = sizeof (MIB_TCP6TABLE);
// Make an initial call to GetTcp6Table to
// get the necessary size into the dwSize variable
if ((dwRetVal = GetTcp6Table(pTcpTable, &dwSize, TRUE)) ==
ERROR_INSUFFICIENT_BUFFER) {
FREE(pTcpTable);
pTcpTable = (MIB_TCP6TABLE *) MALLOC(dwSize);
if (pTcpTable == NULL) {
wprintf(L"Error allocating memory\n");
return 1;
}
}
// Make a second call to GetTcp6Table to get
// the actual data we require
if ((dwRetVal = GetTcp6Table(pTcpTable, &dwSize, TRUE)) == NO_ERROR) {
wprintf(L"\tNumber of entries: %d\n", (int) pTcpTable->dwNumEntries);
for (i = 0; i < (int) pTcpTable->dwNumEntries; i++) {
wprintf(L"\n\tTCP[%d] State: %ld - ", i,
pTcpTable->table[i].State);
switch (pTcpTable->table[i].State) {
case MIB_TCP_STATE_CLOSED:
wprintf(L"CLOSED\n");
break;
case MIB_TCP_STATE_LISTEN:
wprintf(L"LISTEN\n");
break;
case MIB_TCP_STATE_SYN_SENT:
wprintf(L"SYN-SENT\n");
break;
case MIB_TCP_STATE_SYN_RCVD:
wprintf(L"SYN-RECEIVED\n");
break;
case MIB_TCP_STATE_ESTAB:
wprintf(L"ESTABLISHED\n");
break;
case MIB_TCP_STATE_FIN_WAIT1:
wprintf(L"FIN-WAIT-1\n");
break;
case MIB_TCP_STATE_FIN_WAIT2:
wprintf(L"FIN-WAIT-2 \n");
break;
case MIB_TCP_STATE_CLOSE_WAIT:
wprintf(L"CLOSE-WAIT\n");
break;
case MIB_TCP_STATE_CLOSING:
wprintf(L"CLOSING\n");
break;
case MIB_TCP_STATE_LAST_ACK:
wprintf(L"LAST-ACK\n");
break;
case MIB_TCP_STATE_TIME_WAIT:
wprintf(L"TIME-WAIT\n");
break;
case MIB_TCP_STATE_DELETE_TCB:
wprintf(L"DELETE-TCB\n");
break;
default:
wprintf(L"UNKNOWN dwState value\n");
break;
}
if (InetNtop(AF_INET6, &pTcpTable->table[i].LocalAddr, ipstringbuffer, 46) == NULL)
wprintf(L" InetNtop function failed for local IPv6 address\n");
else
wprintf(L"\tTCP[%d] Local Addr: %s\n", i, ipstringbuffer);
wprintf(L"\tTCP[%d] Local Scope ID: %d \n", i,
ntohl (pTcpTable->table[i].dwLocalScopeId));
wprintf(L"\tTCP[%d] Local Port: %d \n", i,
ntohs((u_short)pTcpTable->table[i].dwLocalPort));
if (InetNtop(AF_INET6, &pTcpTable->table[i].RemoteAddr, ipstringbuffer, 46) == NULL)
wprintf(L" InetNtop function failed for remote IPv6 address\n");
else
wprintf(L"\tTCP[%d] Remote Addr: %s\n", i, ipstringbuffer);
wprintf(L"\tTCP[%d] Remote Scope ID: %d \n", i,
ntohl(pTcpTable->table[i].dwRemoteScopeId));
wprintf(L"\tTCP[%d] Remote Port: %d\n", i,
ntohs((u_short)pTcpTable->table[i].dwRemotePort));
}
} else {
wprintf(L"\tGetTcp6Table failed with %d\n", dwRetVal);
FREE(pTcpTable);
return 1;
}
if (pTcpTable != NULL) {
FREE(pTcpTable);
pTcpTable = NULL;
}
return 0;
}
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows Vista [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2008 [somente aplicativos da área de trabalho] |
| Cabeçalho | tcpmib.h (inclua Iphlpapi.h) |