MIBICMPSTATS

The MIBICMPSTATS structure contains statistics for either incoming or outgoing Internet Control Message Protocol (ICMP) messages on a particular computer.

typedef struct _MIBICMPSTATS {
  DWORD   dwMsgs;            // number of messages
  DWORD   dwErrors;          // number of errors
  DWORD   dwDestUnreachs;    // destination unreachable messages 
  DWORD   dwTimeExcds;       // time-to-live exceeded messages
  DWORD   dwParmProbs;       // parameter problem messages
  DWORD   dwSrcQuenchs;      // source quench messages
  DWORD   dwRedirects;       // redirection messages
  DWORD   dwEchos;           // echo requests
  DWORD   dwEchoReps;        // echo replies
  DWORD   dwTimestamps;      // time-stamp requests
  DWORD   dwTimestampReps;   // time-stamp replies
  DWORD   dwAddrMasks;       // address mask requests
  DWORD   dwAddrMaskReps;    // address mask replies
} MIBICMPSTATS;

Members

dwMsgs
Specifies the number of messages received or sent.
dwErrors
Specifies the number of errors received or sent.
dwDestUnreachs
Specifies the number of destination-unreachable messages received or sent. A destination-unreachable message is sent to the originating computer when a datagram fails to reach its intended destination.
dwTimeExcds
Specifies the number of time-to-live (TTL) exceeded messages received or sent. A time-to-live exceeded message is sent to the originating computer when a datagram is discarded because the number of routers it has passed through exceeds its time-to-live value.
dwParmProbs
Specifies the number of parameter-problem messages received or sent. A parameter-problem message is sent to the originating computer when a router or host detects an error in a datagram's IP header.
dwSrcQuenchs
Specifies the number of source quench messages received or sent. A source quench request is sent to a computer to request that it reduce its rate of packet transmission.
dwRedirects
Specifies the number of redirect messages received or sent. A redirect message is sent to the originating computer when a better route is discovered for a datagram sent by that computer.
dwEchos
Specifies the number of echo requests received or sent. An echo request causes the receiving computer to send an echo reply message back to the originating computer.
dwEchoReps
Specifies the number of echo replies received or sent. A computer sends an echo reply in response to receiving an echo request message.
dwTimestamps
Specifies the number of time-stamp requests received or sent. A time-stamp request causes the receiving computer to send a time-stamp reply back to the originating computer.
dwTimestampReps
Specifies the number of time-stamp replies received or sent. A computer sends a time-stamp reply in response to receiving a time-stamp request. Routers can use time-stamp requests and replies to measure the transmission speed of datagrams on a network.
dwAddrMasks
Specifies the number of address mask requests received or sent. A computer sends an address mask request to determine the number of bits in the subnet mask for its local subnet.
dwAddrMaskReps
Specifies the number of address mask responses received or sent. A computer sends an address mask response in response to an address mask request.

Remarks

Two MIBICMPSTATS structures are required to hold all the ICMP statistics for a given computer. One MIBICMPSTATS structure contains the statistics for incoming ICMP messages. The other contains the statistics for outgoing ICMP messages. For this reason, the MIBICMPINFO structure contains two MIBICMPSTATS structures.

Requirements

  Windows NT/2000: Requires Windows NT 4.0 SP4 or later.
  Windows 95/98: Requires Windows 98.
  Header: Declared in Iprtrmib.h.

See Also

MIB_ICMP, MIBICMPINFO