struttura MIB_UDP6ROW_OWNER_MODULE (udpmib.h)

Articolo
08/26/2023

La struttura MIB_UDP6ROW_OWNER_MODULE contiene una voce della tabella del listener UDP (User Datagram Protocol) per IPv6 nel computer locale. Questa voce include anche tutti i dati di proprietà disponibili e l'ID processo (PID) che ha emesso la chiamata alla funzione di associazione per l'endpoint UDP.

Sintassi

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;

Members

ucLocalAddr[16]

Tipo: UCHAR[16]

Indirizzo IPv6 dell'endpoint UDP nel computer locale. Questo membro viene archiviato in una matrice di caratteri in ordine di byte di rete.

Il valore zero indica un listener UDP disposto ad accettare datagrammi per qualsiasi interfaccia IP associata al computer locale.

dwLocalScopeId

Tipo: DWORD

ID ambito per l'indirizzo IPv6 dell'endpoint UDP nel computer locale.

dwLocalPort

Tipo: DWORD

Numero di porta per l'endpoint UDP locale.

dwOwningPid

Tipo: DWORD

PID del processo che ha emesso un binding di contesto per questo endpoint. Se questo valore è impostato su 0, le informazioni per questo endpoint non sono disponibili.

liCreateTimestamp

Tipo: LARGE_INTEGER

Struttura FILETIME che indica quando si è verificata l'operazione di associazione del contesto che ha creato questo endpoint.

SpecificPortBind

Tipo: int

Valore che indica se è stata specificata una porta specifica nell'ultima operazione di associazione del contesto.

dwFlags

Tipo: int

Set di flag. Questo membro non è attualmente utilizzato.

OwningModuleInfo[TCPIP_OWNING_MODULE_SIZE]

Tipo: ULONGLONG[TCPIP_OWNING_MODULE_SIZE]

Matrice di dati opachi che contiene informazioni sulla proprietà.

Commenti

La struttura MIB_UDP6TABLE_OWNER_MODULE viene restituita da una chiamata a GetExtendedUdpTable con il parametro TableClass impostato su un UDP_TABLE_OWNER_MODULE dall'enumerazione UDP_TABLE_CLASS e il parametro ulAf impostato su AF_INET6. La struttura MIB_UDP6TABLE_OWNER_MODULE contiene una matrice di strutture MIB_UDP6ROW_OWNER_MODULE .

Il membro ucLocalAddr viene archiviato in una matrice di caratteri in ordine di byte di rete. In Windows Vista e versioni successive è possibile usare le funzioni RtlIpv6AddressToString o RtlIpv6AddressToStringEx per convertire l'indirizzo IPv6 nel membro ucLocalAddr in una stringa senza caricare la DLL di Windows Sockets.

Il membro dwLocalScopeId è in ordine di byte di rete. Per usare il membro dwLocalScopeId , potrebbero essere necessarie le funzioni ntohl o inet_ntoa in Windows Sockets o funzioni simili.

Il membro dwLocalPort è in ordine di byte di rete. Per usare il membro dwLocalPort , possono essere necessarie le funzioni ntohs o inet_ntoa in Windows Sockets o funzioni simili.

La struttura MIB_UDP6TABLE_OWNER_MODULE contiene la tabella listener UDP per IPv6 nel computer locale. Il nome si basa sulla definizione di questa tabella in RFC 2454 pubblicata da IETF. Per altre informazioni, vedere http://www.ietf.org/rfc/rfc2454.txt. Questa tabella contiene endpoint UDP per IPv6 associati a un indirizzo. Si noti che un'applicazione può creare un socket UDP e associarla a un indirizzo per l'unico scopo di inviare un datagramma UDP, senza alcuna intenzione di ricevere pacchetti usando questo socket (funziona come listener).

In Microsoft Windows Software Development Kit (Windows SDK) (SDK) rilasciato per Windows Vista e versioni successive, l'organizzazione dei file di intestazione è cambiata. Questa struttura è definita nel file di intestazione Udpmib.h , non nel file di intestazione Iprtrmib.h . Si noti che il file di intestazione Udpmib.h viene automaticamente incluso in Iprtrmib.h, incluso automaticamente nel file di intestazione Iphlpapi.h . I file di intestazione Udpmib.h e Iprtrmib.h non devono mai essere usati direttamente.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista, Windows XP con SP2 [solo app desktop]
Server minimo supportato	Windows Server 2008, Windows Server 2003 con SP1 [solo app desktop]
Intestazione	udpmib.h (include Iphlpapi.h)