MIB_UDP6ROW_OWNER_MODULE Struktur (udpmib.h)

Artikel
08/26/2023

Die MIB_UDP6ROW_OWNER_MODULE-Struktur enthält einen Eintrag aus der UDP-Listenertabelle (User Datagram Protocol) für IPv6 auf dem lokalen Computer. Dieser Eintrag enthält auch alle verfügbaren Besitzdaten und die Prozess-ID (PID), die den Aufruf der Bindungsfunktion für den UDP-Endpunkt ausgegeben hat.

Syntax

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;

Member

ucLocalAddr[16]

Typ: UCHAR[16]

Die IPv6-Adresse des UDP-Endpunkts auf dem lokalen Computer. Dieses Element wird in einem Zeichenarray in Netzwerkbytereihenfolge gespeichert.

Der Wert 0 gibt einen UDP-Listener an, der Datagramme für jede IP-Schnittstelle akzeptiert, die dem lokalen Computer zugeordnet ist.

dwLocalScopeId

Art: DWORD

Die Bereichs-ID für die IPv6-Adresse des UDP-Endpunkts auf dem lokalen Computer.

dwLocalPort

Art: DWORD

Die Portnummer für den lokalen UDP-Endpunkt.

dwOwningPid

Art: DWORD

Die PID des Prozesses, der eine Kontextbindung für diesen Endpunkt ausgestellt hat. Wenn dieser Wert auf 0 festgelegt ist, sind die Informationen für diesen Endpunkt nicht verfügbar.

liCreateTimestamp

Typ: LARGE_INTEGER

Eine FILETIME-Struktur , die angibt, wann der Kontextbindungsvorgang, der diesen Endpunkt erstellt hat, aufgetreten ist.

SpecificPortBind

Typ: int

Ein Wert, der angibt, ob im letzten Kontextbindungsvorgang ein bestimmter Port angegeben wurde.

dwFlags

Typ: int

Eine Reihe von Flags. Dieser Member wird derzeit nicht verwendet.

OwningModuleInfo[TCPIP_OWNING_MODULE_SIZE]

Typ: ULONGLONG[TCPIP_OWNING_MODULE_SIZE]

Ein Array undurchsichtiger Daten, das Besitzinformationen enthält.

Hinweise

Die MIB_UDP6TABLE_OWNER_MODULE-Struktur wird durch einen Aufruf von GetExtendedUdpTable zurückgegeben, wobei der TableClass-Parameter auf einen UDP_TABLE_OWNER_MODULE aus der UDP_TABLE_CLASS-Enumeration und der ulAf-Parameter auf AF_INET6 festgelegt ist. Die MIB_UDP6TABLE_OWNER_MODULE-Struktur enthält ein Array von MIB_UDP6ROW_OWNER_MODULE Strukturen.

Das ucLocalAddr-Element wird in einem Zeichenarray in Netzwerkbytereihenfolge gespeichert. Unter Windows Vista und höher können die Funktionen RtlIpv6AddressToString oder RtlIpv6AddressToStringEx verwendet werden, um die IPv6-Adresse im ucLocalAddr-Member in eine Zeichenfolge zu konvertieren, ohne die Windows Sockets-DLL zu laden.

Der dwLocalScopeId-Member befindet sich in Netzwerkbytereihenfolge. Um den dwLocalScopeId-Member verwenden zu können, sind möglicherweise die Funktionen ntohl oder inet_ntoa in Windows Sockets oder ähnlichen Funktionen erforderlich.

Der dwLocalPort-Member befindet sich in Netzwerkbytereihenfolge. Um den dwLocalPort-Member verwenden zu können, sind möglicherweise die Funktionen ntohs oder inet_ntoa in Windows Sockets oder ähnlichen Funktionen erforderlich.

Die MIB_UDP6TABLE_OWNER_MODULE-Struktur enthält die UDP-Listenertabelle für IPv6 auf dem lokalen Computer. Der Name basiert auf der Definition dieser Tabelle in RFC 2454, die von der IETF veröffentlicht wurde. Weitere Informationen finden Sie unter http://www.ietf.org/rfc/rfc2454.txt. Diese Tabelle enthält UDP-Endpunkte für IPv6, die an eine Adresse gebunden wurden. Es sollte beachtet werden, dass eine Anwendung einen UDP-Socket erstellen und ihn an eine Adresse binden kann, um ein UDP-Datagramm zu senden, ohne die Absicht, Pakete mit diesem Socket zu empfangen (die als Listener fungiert).

Im Microsoft Windows Software Development Kit (SDK), das für Windows Vista und höher veröffentlicht wurde, wurde die organization der Headerdateien geändert. Diese Struktur wird in der Headerdatei Udpmib.h definiert, nicht in der Headerdatei Iprtrmib.h . Beachten Sie, dass die Headerdatei Udpmib.h automatisch in Iprtrmib.h enthalten ist, die automatisch in der Headerdatei Iphlpapi.h enthalten ist. Die Headerdateien Udpmib.h und Iprtrmib.h sollten nie direkt verwendet werden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista, Windows XP mit SP2 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008, Windows Server 2003 mit SP1 [nur Desktop-Apps]
Kopfzeile	udpmib.h (include Iphlpapi.h)