Ping::SendPingAsync Method (String^, Int32, array<Byte>^, PingOptions^)
Sends an Internet Control Message Protocol (ICMP) echo message with the specified data buffer to the specified computer, and receive a corresponding ICMP echo reply message from that computer as an asynchronous operation. This overload allows you to specify a time-out value for the operation, a buffer to use for send and receive, and control fragmentation and Time-to-Live values for the ICMP echo message packet.
Assembly: System (in System.dll)
public: [HostProtectionAttribute(SecurityAction::LinkDemand, ExternalThreading = true)] Task<PingReply^>^ SendPingAsync( String^ hostNameOrAddress, int timeout, array<unsigned char>^ buffer, PingOptions^ options )
Parameters
- hostNameOrAddress
-
Type:
System::String^
The computer that is the destination for the ICMP echo message. The value specified for this parameter can be a host name or a string representation of an IP address.
- timeout
-
Type:
System::Int32
The maximum number of milliseconds (after sending the echo message) to wait for the ICMP echo reply message.
- buffer
-
Type:
array<System::Byte>^
A Byte array that contains data to be sent with the ICMP echo message and returned in the ICMP echo reply message. The array cannot contain more than 65,500 bytes.
- options
-
Type:
System.Net.NetworkInformation::PingOptions^
A PingOptions object used to control fragmentation and Time-to-Live values for the ICMP echo message packet.
Return Value
Type: System.Threading.Tasks::Task<PingReply^>^Returns Task<TResult>.
The task object representing the asynchronous operation.
This operation will not block. The returned Task<TResult>> object will complete after the ICMP packet has been sent and the response has been received.
Available since 4.5