WakeOnLAN Method

Sends a Wake-On-LAN packet.

Syntax

ANSI (Cross Platform)
int WakeOnLAN(const char* lpszRemoteHost, const char* lpszMACAddress);

Unicode (Windows)
INT WakeOnLAN(LPCWSTR lpszRemoteHost, LPCWSTR lpszMACAddress);
- (void)wakeOnLAN:(NSString*)remoteHost :(NSString*)MACAddress;
#define MID_PING_WAKEONLAN 7

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

Remarks

When this method is called, a "Wake-On-LAN" packet is sent to RemoteHost (which may also be a broadcast address). This has the effect of powering on the machine (if such functionality is supported by the network card on the remote machine).

The physical address of the remote host must be supplied in the MACAddress parameter.

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]