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