structure MIB_UDPROW_OWNER_PID (udpmib.h)

Article
03/03/2024

La structure MIB_UDPROW_OWNER_PID contient une entrée de la table d’écouteur UDP (User Datagram Protocol) pour IPv4 sur l’ordinateur local. L’entrée inclut également l’ID de processus (PID) qui a émis l’appel à la fonction bind pour le point de terminaison UDP.

Syntaxe

typedef struct _MIB_UDPROW_OWNER_PID {
  DWORD dwLocalAddr;
  DWORD dwLocalPort;
  DWORD dwOwningPid;
} MIB_UDPROW_OWNER_PID, *PMIB_UDPROW_OWNER_PID;

Membres

dwLocalAddr

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 n’importe quelle interface IP associée à l’ordinateur local.

dwLocalPort

Numéro de port du point de terminaison UDP sur l’ordinateur local. Ce membre est stocké dans l’ordre d’octet réseau.

dwOwningPid

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.

Remarques

La structure MIB_UDPTABLE_OWNER_PID est retournée par un appel à GetExtendedUdpTable avec le paramètre TableClass défini sur UDP_TABLE_OWNER_PID et le paramètre ulAf défini sur AF_INET. La structure MIB_UDPTABLE_OWNER_PID contient un tableau de structures MIB_UDPROW_OWNER_PID .

Le membre dwLocalAddr est stocké en tant que DWORD au même format que la structure in_addr . Pour utiliser le membre dwLocalAddr , les fonctions ntohl ou inet_ntoa dans des sockets Windows 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 du socket Windows.

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_UDPTABLE_OWNER_PID 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 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)