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.
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