BeginSendIcmp(String,Object) Method

Asynchronously determine if a host is reachable.

[Visual Basic]
<DescriptionAttribute("Begin an asynchronous ICMP Ping with a remote host.")>
Overloads Public Function BeginSendIcmp( _
   ByVal remoteHost As String, _
   ByVal state As Object _
) As Integer

[C#]
[DescriptionAttribute("Begin an asynchronous ICMP Ping with a remote host.")]
public int BeginSendIcmp( 
   string remoteHost,
   object state
);

[C++]
[DescriptionAttribute("Begin an asynchronous ICMP Ping with a remote host.")]
public: int BeginSendIcmp( 
   string* remoteHost,
   Object* state
) 

[C++/CLI]
[DescriptionAttribute("Begin an asynchronous ICMP Ping with a remote host.")]
public:
int BeginSendIcmp( 
   String^ remoteHost,
   Object^ state
) 

Parameters

remoteHost

Hostname or dot address of the host to ping.

state

User state information.

Return Type

An IAsyncResult that represents the asynchronous ping operation, which could still be pending.

Exceptions

Remarks

This method asynchronously pings the host specified by remoteHost with default settings (TTL = 128, data = 32 occurrences of "&"). Upon completion the EndSend event is raised. An EchoResult object is made accessible in the event, describing the ping operation. Check the properties of the EchoResult for data about the Ping operation. For example, ResponseTime returns the amount of time for the response to be received.

BeginSendIcmp differs from BeginSend in that multiple requests are all sent on a single thread as opposed to BeginSend which each request is made on a separate thread, which may limit the number of outstanding requests to the number of available threads. BeginSendIcmp is nearly unlimited in the number of outstanding requests it may have.

Requirements

Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family

See Also

Ping Class  | Ping Members  | Overload List