struttura MIB_UDP6ROW_OWNER_MODULE (udpmib.h)
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) |