MIB_UDPROW_OWNER_MODULE structure (udpmib.h)

Article
03/03/2024

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)