MIB_UDPROW_OWNER_MODULE structure (udpmib.h)
La structure MIB_UDPROW_OWNER_MODULE contient une entrée de la table d’écouteur UDP (User Datagram Protocol) IPv4 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_UDPROW_OWNER_MODULE {
DWORD dwLocalAddr;
DWORD dwLocalPort;
DWORD dwOwningPid;
LARGE_INTEGER liCreateTimestamp;
union {
struct {
int SpecificPortBind : 1;
};
int dwFlags;
};
ULONGLONG OwningModuleInfo[TCPIP_OWNING_MODULE_SIZE];
} MIB_UDPROW_OWNER_MODULE, *PMIB_UDPROW_OWNER_MODULE;
Membres
dwLocalAddr
Type : DWORD
Adresse IPv4 du point de terminaison UDP sur l’ordinateur local.
La valeur zéro indique un écouteur UDP prêt à accepter des datagrammes pour toute interface IP associée à l’ordinateur local.
dwLocalPort
Type : DWORD
Numéro de port du point de terminaison UDP sur l’ordinateur local. Ce membre est stocké dans l’ordre d’octet du réseau.
dwOwningPid
Type : DWORD
PID du processus qui a émis l’appel à la fonction de liaison pour le point de terminaison UDP. Ce membre est défini sur 0 lorsque le PID n’est pas disponible.
liCreateTimestamp
Type : LARGE_INTEGER
Structure FILETIME qui indique quand l’appel à la fonction de liaison pour le point de terminaison UDP s’est produit.
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_UDPTABLE_OWNER_MODULE est retournée par un appel à GetExtendedUdpTable avec le paramètre TableClass défini sur UDP_TABLE_OWNER_MODULE à partir de l’énumération UDP_TABLE_CLASS et le paramètre ulAf défini sur AF_INET. La structure MIB_UDPTABLE_OWNER_MODULE contient un tableau de structures MIB_UDPROW_OWNER_MODULE .
Le membre dwLocalAddr est stocké en tant que DWORD dans le même format que la structure in_addr . Pour utiliser le membre dwLocalAddr , les fonctions ntohl ou inet_ntoa dans windows Sockets ou des fonctions similaires peuvent être nécessaires. Sur Windows Vista et versions ultérieures, les fonctions RtlIpv4AddressToString ou RtlIpv4AddressToStringEx peuvent être utilisées pour convertir l’adresse IPv4 du membre dwLocalAddr en chaîne sans charger la DLL Windows Sockets.
Le membre dwLocalPort est dans l’ordre d’octet du réseau. Pour utiliser le membre dwLocalPort , les fonctions ntohs ou inet_ntoa dans Windows Sockets ou des fonctions similaires peuvent être nécessaires.
La structure MIB_UDPTABLE_OWNER_MODULE contient la table d’écouteur UDP pour IPv4 sur l’ordinateur local. Le nom est basé sur la définition de cette table dans la RFC 1213 publiée par l’IETF. Pour plus d’informations, consultez http://www.ietf.org/rfc/rfc1213.txt. Cette table contient des points de terminaison UDP pour IPv4 qui ont été liés à une adresse. Il est à 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 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 , et non 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 (include Iphlpapi.h) |