структура MIB_TCP6ROW_OWNER_PID (tcpmib.h)

Статья
08/26/2023

Структура MIB_TCP6ROW_OWNER_PID содержит сведения, описывающие TCP-подключение IPv6, связанное с определенным идентификатором процесса (PID).

Синтаксис

typedef struct _MIB_TCP6ROW_OWNER_PID {
  UCHAR ucLocalAddr[16];
  DWORD dwLocalScopeId;
  DWORD dwLocalPort;
  UCHAR ucRemoteAddr[16];
  DWORD dwRemoteScopeId;
  DWORD dwRemotePort;
  DWORD dwState;
  DWORD dwOwningPid;
} MIB_TCP6ROW_OWNER_PID, *PMIB_TCP6ROW_OWNER_PID;

Члены

ucLocalAddr[16]

Тип: UCHAR[16]

IPv6-адрес для локальной конечной точки TCP-подключения на локальном компьютере. Нулевое значение указывает, что прослушиватель может принимать подключение к любому интерфейсу.

dwLocalScopeId

Тип: DWORD

Идентификатор область в сетевом порядке байтов для локального IPv6-адреса.

dwLocalPort

Тип: DWORD

Номер порта в порядке байтов сети для локальной конечной точки TCP-подключения на локальном компьютере.

ucRemoteAddr[16]

Тип: UCHAR[16]

IPv6-адрес удаленной конечной точки TCP-подключения на удаленном компьютере. Если элемент dwStateMIB_TCP_STATE_LISTEN, это значение не имеет смысла.

dwRemoteScopeId

Тип: DWORD

Идентификатор область в сетевом порядке байтов для удаленного IPv6-адреса.

dwRemotePort

Тип: DWORD

Номер порта в порядке байтов сети для удаленной конечной точки TCP-подключения на удаленном компьютере.

dwState

Тип: DWORD

Состояние TCP-подключения. Этот член может быть одним из значений перечисления MIB_TCP_STATE , определенного в файле заголовка Tcpmib.h . Обратите внимание, что файл заголовка Tcpmib.h автоматически включается в iprtrmib.h, который автоматически включается в файл заголовка Iphlpapi.h . Файлы заголовков Tcpmib.h и Iprtrmib.h никогда не следует использовать напрямую.

Значение	Значение
MIB_TCP_STATE_CLOSED 1	TCP-подключение находится в состоянии CLOSED, которое вообще не представляет состояние соединения.
MIB_TCP_STATE_LISTEN 2	TCP-подключение находится в состоянии ПРОСЛУШИВАНИЯ, ожидая запроса на подключение от любого удаленного TCP и порта.
MIB_TCP_STATE_SYN_SENT 3	TCP-подключение находится в состоянии SYN-SENT, ожидая соответствующего запроса на подключение после отправки запроса на подключение (пакет SYN).
MIB_TCP_STATE_SYN_RCVD 4	TCP-подключение находится в состоянии SYN-RECEIVED, ожидая подтверждения запроса на подключение после получения и отправки запроса на подключение (пакет SYN).
MIB_TCP_STATE_ESTAB 5	TCP-подключение находится в состоянии УСТАНОВЛЕНО, представляющее открытое подключение, и полученные данные могут быть доставлены пользователю. Это нормальное состояние для этапа передачи данных TCP-подключения.
MIB_TCP_STATE_FIN_WAIT1 6	TCP-подключение — это состояние FIN-WAIT-1, ожидающее запроса на завершение подключения от удаленного TCP или подтверждения ранее отправленного запроса на завершение подключения.
MIB_TCP_STATE_FIN_WAIT2 7	TCP-подключение находится в состоянии FIN-WAIT-1, ожидающем запроса на завершение подключения от удаленного TCP.
MIB_TCP_STATE_CLOSE_WAIT 8	TCP-подключение находится в состоянии CLOSE-WAIT, ожидая запроса на завершение подключения от локального пользователя.
MIB_TCP_STATE_CLOSING 9	TCP-подключение находится в состоянии CLOSING, ожидая подтверждения запроса на завершение подключения от удаленного TCP.
MIB_TCP_STATE_LAST_ACK 10	TCP-подключение находится в состоянии LAST-ACK, ожидая подтверждения запроса на завершение подключения, ранее отправленного на удаленный TCP (который включает подтверждение его запроса на завершение подключения).
MIB_TCP_STATE_TIME_WAIT 11	TCP-подключение находится в состоянии TIME-WAIT, ожидая достаточно времени, чтобы убедиться, что удаленный TCP получил подтверждение своего запроса на завершение подключения.
MIB_TCP_STATE_DELETE_TCB 12	TCP-подключение находится в состоянии удаления TCB, представляющего удаление блока управления передачей (TCB), структуры данных, используемой для хранения сведений о каждой записи TCP.

dwOwningPid

Тип: DWORD

Идентификатор идентификатора локального процесса, выдавшего привязку контекста для этого TCP-подключения.

Структура MIB_TCP6TABLE_OWNER_PID возвращается вызовом Метода GetExtendedTcpTable с параметром TableClass , заданным TCP_TABLE_OWNER_PID_LISTENER, TCP_TABLE_OWNER_PID_CONNECTIONS или TCP_TABLE_OWNER_PID_ALL из перечисления TCP_TABLE_CLASS , а параметр ulAf имеет значение AF_INET6. Структура MIB_TCP6TABLE_OWNER_PID содержит массив MIB_TCP6ROW_OWNER_PID структур.

Член dwState указывает состояние записи TCP на схеме состояния TCP. Tcp-подключение проходит через ряд состояний в течение его существования. Состояния: LISTEN, SYN-SENT, SYN-RECEIVED, ESTABLISHED, FIN-WAIT-1, FIN-WAIT-2, CLOSE-WAIT, CLOSED, LAST-ACK, TIME-WAIT и вымышленное состояние CLOSED. Состояние CLOSED является вымышленным, так как оно представляет состояние, когда нет блока управления передачей и, следовательно, нет подключения. Протокол TCP описан в документе RFC 793. Для получения дополнительной информации см. http://www.ietf.org/rfc/rfc793.txt.

Члены dwLocalPort и dwRemotePort находятся в сетевом порядке байтов. Чтобы использовать члены dwLocalPort или dwRemotePort , могут потребоваться функции ntohs или inet_ntoa в сокетах Windows или аналогичные функции.

Члены dwLocalScopeId и dwRemoteScopeId находятся в порядке байтов в сети. Чтобы использовать члены dwLocalScopeId или dwRemoteScopeId , могут потребоваться функции ntohl или inet_ntoa в сокетах Windows или аналогичные функции.

Члены ucLocalAddr и ucRemoteAddr хранятся в массиве символов в порядке байтов по сети. Функции RtlIpv6AddressToString или RtlIpv6AddressToStringEx можно использовать для преобразования IPv6-адреса в членах ucLocalAddr или ucRemoteAddr в строку без загрузки библиотеки DLL сокетов Windows.

В пакете средств разработки программного обеспечения (SDK) Microsoft Windows, выпущенных для Windows Vista и более поздних версий, организация файлов заголовков изменилась. Эта структура определяется в файле заголовка Tcpmib.h , а не в файле заголовка Iprtrmib.h . Обратите внимание, что файл заголовка Tcpmib.h автоматически включается в iprtrmib.h, который автоматически включается в файл заголовка Iphlpapi.h . Файлы заголовков Tcpmib.h и Iprtrmib.h никогда не следует использовать напрямую.

Требования


Минимальная версия клиента	Windows Vista, Windows XP с пакетом обновления 2 (SP2) [только классические приложения]
Минимальная версия сервера	Windows Server 2008, Windows Server 2003 с пакетом обновления 1 (SP1) [только классические приложения]
Верхняя часть	tcpmib.h (включая Iphlpapi.h)