PingHost Method

Pings a host.

Syntax

ANSI (Cross Platform)
int PingHost(const char* lpszHost);

Unicode (Windows)
INT PingHost(LPCWSTR lpszHost);
- (void)pingHost:(NSString*)host;
#define MID_PING_PINGHOST 5

IPWORKS_EXTERNAL int IPWORKS_CALL IPWorks_Ping_Do(void *lpObj, int methid, int cparam, void *param[], int cbparam[], int64 *lpllVal);

Remarks

This method will ping a host. A valid internet domain name or address must be specified in Host, or an error will be returned.

PING request (ICMP ECHO) is sent to Host.

Example (Ping a Host)


PingControl.PingHost("MyHostName")
ResponseTime = PingControl.ResponseTime

Error Handling (C++)

This method returns a result code; 0 indicates success, while a non-zero error code indicates that this method encountered an error during its execution. If an error occurs, the GetLastError() method can be called to retrieve the associated error message. (Note: This method's result code can also be obtained by calling the GetLastErrorCode() method after it returns.)
Copyright (c) 2022 /n software inc. - All rights reserved.
IPWorks 2020 C++ Edition - Version 20.0 [Build 8307]