структура MIB_UDPROW_OWNER_MODULE (udpmib.h)

Статья
08/26/2023

Структура MIB_UDPROW_OWNER_MODULE содержит запись из таблицы прослушивателя IPv4 User Datagram Protocol (UDP) на локальном компьютере. Эта запись также включает все доступные данные владения и идентификатор процесса (PID), который выдал вызов функции привязки для конечной точки UDP.

Синтаксис

typedef struct _MIB_UDPROW_OWNER_MODULE {
  DWORD         dwLocalAddr;
  DWORD         dwLocalPort;
  DWORD         dwOwningPid;
  LARGE_INTEGER liCreateTimestamp;
  union {
    struct {
      int SpecificPortBind : 1;
    };
    int dwFlags;
  };
  ULONGLONG     OwningModuleInfo[TCPIP_OWNING_MODULE_SIZE];
} MIB_UDPROW_OWNER_MODULE, *PMIB_UDPROW_OWNER_MODULE;

Члены

dwLocalAddr

Тип: DWORD

IPv4-адрес конечной точки UDP на локальном компьютере.

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

dwLocalPort

Тип: DWORD

Номер порта конечной точки UDP на локальном компьютере. Этот элемент хранится в порядке байтов сети.

dwOwningPid

Тип: DWORD

Идентификатор идентификатора процесса, который выполнил вызов функции привязки для конечной точки UDP. Этот элемент имеет значение 0, если PID недоступен.

liCreateTimestamp

Тип: LARGE_INTEGER

Структура FILETIME , указывающая, когда произошел вызов функции привязки для конечной точки UDP.

SpecificPortBind

Тип: int

Значение типа , указывающее, был ли указан конкретный порт в последней операции привязки контекста.

dwFlags

Тип: int

Набор флагов. Этот элемент в настоящее время не используется.

OwningModuleInfo[TCPIP_OWNING_MODULE_SIZE]

Тип: ULONGLONG[TCPIP_OWNING_MODULE_SIZE]

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

Структура MIB_UDPTABLE_OWNER_MODULE возвращается вызовом Метода GetExtendedUdpTable , для параметра TableClass задано значение UDP_TABLE_OWNER_MODULE из перечисления UDP_TABLE_CLASS , а для параметра ulAf — значение AF_INET. Структура MIB_UDPTABLE_OWNER_MODULE содержит массив MIB_UDPROW_OWNER_MODULE структур.

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

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

Структура MIB_UDPTABLE_OWNER_MODULE содержит таблицу прослушивателя UDP для IPv4 на локальном компьютере. Имя основано на определении этой таблицы в RFC 1213, опубликованном IETF. Для получения дополнительной информации см. http://www.ietf.org/rfc/rfc1213.txt. Эта таблица содержит конечные точки UDP для IPv4, привязанные к адресу. Следует отметить, что приложение может создать сокет UDP и привязать его к адресу с единственной целью отправки датаграммы UDP, не имея намерения получать пакеты с помощью этого сокета (функционирующего в качестве прослушивателя).

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

Требования

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