structure MIB_UDP6ROW_OWNER_MODULE (udpmib.h)
La structure MIB_UDP6ROW_OWNER_MODULE contient une entrée de la table d’écouteur UDP (User Datagram Protocol) pour IPv6 sur l’ordinateur local. Cette entrée inclut également toutes les données de propriété disponibles et l’ID de processus (PID) qui a émis l’appel à la fonction de liaison pour le point de terminaison UDP.
Syntaxe
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;
Membres
ucLocalAddr[16]
Type : UCHAR[16]
Adresse IPv6 du point de terminaison UDP sur l’ordinateur local. Ce membre est stocké dans un tableau de caractères dans l’ordre d’octet réseau.
La valeur zéro indique un écouteur UDP prêt à accepter des datagrammes pour n’importe quelle interface IP associée à l’ordinateur local.
dwLocalScopeId
Type : DWORD
ID d’étendue pour l’adresse IPv6 du point de terminaison UDP sur l’ordinateur local.
dwLocalPort
Type : DWORD
Numéro de port du point de terminaison UDP local.
dwOwningPid
Type : DWORD
PID du processus qui a émis une liaison de contexte pour ce point de terminaison. Si cette valeur est définie sur 0, les informations relatives à ce point de terminaison ne sont pas disponibles.
liCreateTimestamp
Type : LARGE_INTEGER
Structure FILETIME qui indique quand l’opération de liaison de contexte qui a créé ce point de terminaison s’est produite.
SpecificPortBind
Type : int
Valeur qui indique si un port spécifique a été spécifié dans la dernière opération de liaison de contexte.
dwFlags
Type : int
Ensemble d’indicateurs. Ce membre n’est actuellement pas utilisé.
OwningModuleInfo[TCPIP_OWNING_MODULE_SIZE]
Type : ULONGLONG[TCPIP_OWNING_MODULE_SIZE]
Tableau de données opaques qui contient des informations de propriété.
Remarques
La structure MIB_UDP6TABLE_OWNER_MODULE est renvoyée par un appel à GetExtendedUdpTable avec le paramètre TableClass défini sur un UDP_TABLE_OWNER_MODULE à partir de l’énumération UDP_TABLE_CLASS et le paramètre ulAf défini sur AF_INET6. La structure MIB_UDP6TABLE_OWNER_MODULE contient un tableau de structures MIB_UDP6ROW_OWNER_MODULE .
Le membre ucLocalAddr est stocké dans un tableau de caractères dans l’ordre d’octet réseau. Sur Windows Vista et versions ultérieures, les fonctions RtlIpv6AddressToString ou RtlIpv6AddressToStringEx peuvent être utilisées pour convertir l’adresse IPv6 du membre ucLocalAddr en chaîne sans charger la DLL Windows Sockets.
Le membre dwLocalScopeId est dans l’ordre d’octet réseau. Pour utiliser le membre dwLocalScopeId , les fonctions ntohl ou inet_ntoa dans les sockets Windows ou des fonctions similaires peuvent être nécessaires.
Le membre dwLocalPort est dans l’ordre d’octet réseau. Pour utiliser le membre dwLocalPort , les fonctions ntohs ou inet_ntoa dans les sockets Windows ou des fonctions similaires peuvent être nécessaires.
La structure MIB_UDP6TABLE_OWNER_MODULE contient la table d’écouteur UDP pour IPv6 sur l’ordinateur local. Le nom est basé sur la définition de cette table dans la RFC 2454 publiée par l’IETF. Pour plus d’informations, consultez http://www.ietf.org/rfc/rfc2454.txt. Cette table contient les points de terminaison UDP pour IPv6 qui ont été liés à une adresse. Il convient de noter qu’une application peut créer un socket UDP et le lier à une adresse dans le seul but d’envoyer un datagramme UDP, sans intention de recevoir des paquets à l’aide de ce socket (fonctionnant comme un écouteur).
Sur le Microsoft Kit de développement logiciel Windows (Kit SDK Windows) (SDK) publié pour Windows Vista et versions ultérieures, la organization des fichiers d’en-tête a changé. Cette structure est définie dans le fichier d’en-tête Udpmib.h , pas dans le fichier d’en-tête Iprtrmib.h . Notez que le fichier d’en-tête Udpmib.h est automatiquement inclus dans Iprtrmib.h, qui est automatiquement inclus dans le fichier d’en-tête Iphlpapi.h . Les fichiers d’en-tête Udpmib.h et Iprtrmib.h ne doivent jamais être utilisés directement.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows Vista, Windows XP avec SP2 [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2008, Windows Server 2003 avec SP1 [applications de bureau uniquement] |
| En-tête | udpmib.h (inclure Iphlpapi.h) |