MIB_IPSTATS_LH structure (ipmib.h)

La structure MIB_IPSTATS stocke des informations sur le protocole IP en cours d’exécution sur un ordinateur particulier.

Syntaxe

typedef struct _MIB_IPSTATS_LH {
  union {
    DWORD                  dwForwarding;
    MIB_IPSTATS_FORWARDING Forwarding;
  };
  DWORD dwDefaultTTL;
  DWORD dwInReceives;
  DWORD dwInHdrErrors;
  DWORD dwInAddrErrors;
  DWORD dwForwDatagrams;
  DWORD dwInUnknownProtos;
  DWORD dwInDiscards;
  DWORD dwInDelivers;
  DWORD dwOutRequests;
  DWORD dwRoutingDiscards;
  DWORD dwOutDiscards;
  DWORD dwOutNoRoutes;
  DWORD dwReasmTimeout;
  DWORD dwReasmReqds;
  DWORD dwReasmOks;
  DWORD dwReasmFails;
  DWORD dwFragOks;
  DWORD dwFragFails;
  DWORD dwFragCreates;
  DWORD dwNumIf;
  DWORD dwNumAddr;
  DWORD dwNumRoutes;
} MIB_IPSTATS_LH, *PMIB_IPSTATS_LH;

Membres

dwForwarding

Type : DWORD

Spécifie si le transfert IP est activé ou désactivé pour un protocole (IPv4 ou IPv6).

Sur Windows Vista et versions ultérieures, ce membre est défini comme une union contenant un membre DWORD dwForwarding et un membre de transfert MIB_IPSTATS_FORWARDING où MIB_IPSTATS_FORWARDING est une énumération définie dans le fichier d’en-tête Ipmib.h .

Valeur	Signification
MIB_IP_FORWARDING 1	Le transfert IP est activé.
MIB_IP_NOT_FORWARDING 2	Le transfert IP n’est pas activé.
MIB_USE_CURRENT_FORWARDING 0xffff	Utilisez le paramètre de transfert IP actuel. Cette valeur s’applique uniquement lors de la définition des options de transfert et de durée de vie (TTL) à l’aide des fonctions SetIpStatistics et SetIpStatisticsEx .

Forwarding

dwDefaultTTL

Type : DWORD

Durée de vie initiale (TTL) par défaut pour les datagrammes provenant d’un ordinateur particulier.

Ce membre peut être défini sur MIB_USE_CURRENT_TTL pour utiliser la valeur TTL par défaut actuelle lors de la définition des options de transfert et de durée de vie (TTL) à l’aide des fonctions SetIpStatistics et SetIpStatisticsEx .

dwInReceives

Type : DWORD

Nombre de datagrammes reçus.

dwInHdrErrors

Type : DWORD

Nombre de datagrammes reçus qui ont des erreurs d’en-tête.

dwInAddrErrors

Type : DWORD

Nombre de datagrammes reçus qui ont des erreurs d’adresse.

dwForwDatagrams

Type : DWORD

Nombre de datagrammes transférés.

dwInUnknownProtos

Type : DWORD

Nombre de datagrammes reçus qui ont un protocole inconnu.

dwInDiscards

Type : DWORD

Nombre de datagrammes reçus ignorés.

dwInDelivers

Type : DWORD

Nombre de datagrammes reçus remis.

dwOutRequests

Type : DWORD

Nombre de datagrammes sortants que l’adresse IP est demandée à transmettre. Ce nombre n’inclut pas les datagrammes transférés.

dwRoutingDiscards

Type : DWORD

Nombre de datagrammes sortants ignorés.

dwOutDiscards

Type : DWORD

Nombre de datagrammes transmis ignorés.

dwOutNoRoutes

Type : DWORD

Nombre de datagrammes pour lesquels cet ordinateur n’avait pas d’itinéraire vers l’adresse IP de destination. Ces datagrammes ont été ignorés.

dwReasmTimeout

Type : DWORD

Durée d’arrivée de tous les éléments d’un datagramme fragmenté. Si tous les éléments n’arrivent pas dans ce délai, le datagramme est ignoré.

dwReasmReqds

Type : DWORD

Nombre de datagrammes qui nécessitent un re-assembly.

dwReasmOks

Type : DWORD

Nombre de datagrammes qui ont été correctement réassemblages.

dwReasmFails

Type : DWORD

Nombre de datagrammes qui ne peuvent pas être réassemblages.

dwFragOks

Type : DWORD

Nombre de datagrammes qui ont été fragmentés avec succès.

dwFragFails

Type : DWORD

Nombre de datagrammes qui n’ont pas été fragmentés, car l’en-tête IP ne spécifie aucune fragmentation. Ces datagrammes sont ignorés.

dwFragCreates

Type : DWORD

Nombre de fragments créés.

dwNumIf

Type : DWORD

Nombre d’interfaces.

dwNumAddr

Type : DWORD

Nombre d’adresses IP associées à cet ordinateur.

dwNumRoutes

Type : DWORD

Nombre d’itinéraires dans la table de routage IP.

Remarques

La structure MIB_IPSTATS stocke des informations par protocole (IPv4 ou IPv6).

Le membre dwForwarding spécifie l’état de transfert par protocole pour IPv4 ou IPv6, et non l’état de transfert pour une interface. L’état de transfert de chaque état d’interface est l’état affecté pour cette interface. L’état par protocole retourné par la fonction GetIpStatistics ou GetIpStatisticsEx n’est pas l’état de transfert dans affect. Le membre dwForwarding existe pour servir deux objectifs :

• Fournit une valeur par défaut pour l’état de transfert lorsqu’une nouvelle interface est créée sans état de transfert spécifique (ni désactivé ni activé). Cette valeur est héritée par état de protocole.
• Fournit une valeur définie par un administrateur de domaine pour activer ou désactiver un état de transfert par protocole. Les états de transfert de toutes les interfaces utilisant ce protocole sont également activés ou désactivés.

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é et la structure MIB_IPSTATS est définie dans le fichier d’en-tête Ipmib.h et non dans le fichier d’en-tête Iprtrmib.h. Notez que le fichier d’en-tête Ipmib.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 Ipmib.h et Iprtrmib.h ne doivent jamais être utilisés directement.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
En-tête	ipmib.h (include Iphlpapi.h)

Voir aussi

GetIpStatistics

GetIpStatisticsEx

SetIpStatistics

SetIpStatisticsEx