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

Статья
08/26/2023

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

Синтаксис

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;

Члены

dwState

Тип: DWORD

dwState

Тип: DWORD Состояние TCP-подключения. Этот элемент может быть одним из значений, определенных в файле заголовка Iprtrmib.h .

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

Значение	Значение
MIB_TCP_STATE_CLOSED 1	TCP-подключение находится в состоянии CLOSED, которое не представляет никакого состояния соединения.
MIB_TCP_STATE_LISTEN 2	TCP-подключение находится в состоянии LISTEN, ожидая запроса на подключение из любого удаленного 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.

dwLocalAddr

Тип: DWORD

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

dwLocalPort

Тип: DWORD

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

dwRemoteAddr

Тип: DWORD

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

dwRemotePort

Тип: DWORD

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

dwOwningPid

Тип: DWORD

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

liCreateTimestamp

Тип: LARGE_INTEGER

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

OwningModuleInfo[TCPIP_OWNING_MODULE_SIZE]

Тип: ULONGLONG[TCPIP_OWNING_MODULE_SIZE]

Массив непрозрачных данных, содержащий сведения о владельцах.

Структура MIB_TCPROW_OWNER_MODULE возвращается вызовом Метода GetExtendedTcpTable с параметром TableClass , равным TCP_TABLE_OWNER_MODULE_LISTENER, TCP_TABLE_OWNER_MODULE_CONNECTIONS или TCP_TABLE_OWNER_MODULE_ALL из перечисления TCP_TABLE_CLASS , а для параметра ulAf задано значение AF_INET4.

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

Элементы dwLocalPort и dwRemotePort находятся в порядке байтов сети. Для использования элементов dwLocalPort или dwRemotePort могут потребоваться функции ntohs или inet_ntoa в сокетах Windows или аналогичные функции. Элементы dwLocalAddr и dwRemoteAddr хранятся в виде DWORD в том же формате, что и структура in_addr . Для использования элементов dwLocalAddr или dwRemoteAddr могут потребоваться функции ntohl или inet_ntoa в сокетах Windows или аналогичные функции. В Windows Vista и более поздних версиях функции RtlIpv4AddressToString или RtlIpv4AddressToStringEx можно использовать для преобразования IPv4-адреса в элементах dwLocalAddr или dwRemoteAddr в строку без загрузки библиотеки DLL Windows Sockets.

На Windows SDK, выпущенном для 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)