MIB_UDP6ROW_OWNER_PID structure (udpmib.h)

Article
03/03/2024

La structure MIB_UDP6ROW_OWNER_PID contient une entrée de la table d’écouteur UDP (User Datagram Protocol) pour IPv6 sur l’ordinateur local. L’entrée inclut également 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_PID {
  UCHAR ucLocalAddr[16];
  DWORD dwLocalScopeId;
  DWORD dwLocalPort;
  DWORD dwOwningPid;
} MIB_UDP6ROW_OWNER_PID, *PMIB_UDP6ROW_OWNER_PID;

Membres

ucLocalAddr[16]

Adresse IPv6 du point de terminaison UDP local. Ce membre est stocké dans un tableau de caractères dans l’ordre d’octets réseau.

La valeur zéro indique un écouteur UDP prêt à accepter des datagrammes pour toute interface IP associée à l’ordinateur local.

dwLocalScopeId

ID d’étendue pour l’adresse IPv6 du point de terminaison UDP sur l’ordinateur local. Ce membre est stocké dans l’ordre d’octet du réseau.

dwLocalPort

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

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.

Remarques

La structure MIB_UDP6TABLE_OWNER_PID est retournée par un appel à GetExtendedUdpTable avec le paramètre TableClass défini sur un UDP_TABLE_OWNER_PID à partir de l’énumération UDP_TABLE_CLASS et le paramètre ulAf défini sur AF_INET6. La structure MIB_UDP6TABLE_OWNER_PID contient un tableau de structures MIB_UDP6ROW_OWNER_PID .

Le membre ucLocalAddr est stocké dans un tableau de caractères dans l’ordre d’octets 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 du réseau. Pour utiliser le membre dwLocalScopeId , les fonctions ntohl ou inet_ntoa dans Windows Sockets 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 Windows Sockets ou des fonctions similaires peuvent être nécessaires.

La structure MIB_UDP6TABLE_OWNER_PID 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 des points de terminaison UDP pour IPv6 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)