The GetTimeToLive method returns the time-to-live for the
last ICMP echo datagram received by the client.
Parameters
None.
Return Value
If the method succeeds, the return value is the time-to-live for
the last datagram. If the method fails, the return value is
ICMP_ERROR. To get extended error information, call
GetLastError.
Remarks
The time-to-live (TTL) value is specified in the IP header of a
datagram, and is used to control the number of routers that the
datagram is passed through. Each router that handles the datagram
decrements the TTL value by one. When it drops to zero, a datagram is
returned to the sender, specifying that the TTL has been exceeded.
The default value is 255.
Requirements
Minimum Desktop Platform: Windows 7 Service Pack 1
Minimum Server Platform: Windows Server 2008 R2 Service Pack 1
Header File: cstools11.h
Import Library: csicmv11.lib
See Also
GetPacketSize,
GetRecvCount,
GetSendCount,
GetSequenceId,
GetTripTime,
SetSequenceId,
SetTimeToLive
|