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

Статья
08/26/2023

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

Синтаксис

typedef struct _MIB_UDP6ROW_OWNER_MODULE {
  UCHAR         ucLocalAddr[16];
  DWORD         dwLocalScopeId;
  DWORD         dwLocalPort;
  DWORD         dwOwningPid;
  LARGE_INTEGER liCreateTimestamp;
  union {
    struct {
      int SpecificPortBind : 1;
    };
    int dwFlags;
  };
  ULONGLONG     OwningModuleInfo[TCPIP_OWNING_MODULE_SIZE];
} MIB_UDP6ROW_OWNER_MODULE, *PMIB_UDP6ROW_OWNER_MODULE;

Члены

ucLocalAddr[16]

Тип: UCHAR[16]

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

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

dwLocalScopeId

Тип: DWORD

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

dwLocalPort

Тип: DWORD

Номер порта для локальной конечной точки UDP.

dwOwningPid

Тип: DWORD

PiD процесса, выдавшего привязку контекста для этой конечной точки. Если это значение равно 0, сведения для этой конечной точки будут недоступны.

liCreateTimestamp

Тип: LARGE_INTEGER

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

SpecificPortBind

Тип: int

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

dwFlags

Тип: int

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

OwningModuleInfo[TCPIP_OWNING_MODULE_SIZE]

Тип: ULONGLONG[TCPIP_OWNING_MODULE_SIZE]

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

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

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

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

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

Структура MIB_UDP6TABLE_OWNER_MODULE содержит таблицу прослушивателя UDP для IPv6 на локальном компьютере. Имя основано на определении этой таблицы в документе RFC 2454, опубликованном IETF. Для получения дополнительной информации см. http://www.ietf.org/rfc/rfc2454.txt. Эта таблица содержит конечные точки UDP для IPv6, привязанные к адресу. Следует отметить, что приложение может создать сокет 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)