The CeRunAppAtTime function prompts the system to start running a given application at a given time.
BOOL CeRunAppAtTime(TCHAR *pwszAppName, SYSTEMTIME *lpTime);
Header file: | Notify.h |
Platforms: | H/PC |
Versions: | 1.01 and later |
If the function succeeds, the return value is TRUE. If the function fails, the return value is FALSE.
Calling the CeRunAppAtTime function replaces any previous run request for the specified application.
The system passes the APP_RUN_AT_TIME string to the application as the command line. If an instance of the application is already running, the new instance must send a private message to the existing instance and then shut down.
Use CeRunAppAtTime sparingly because automatically starting an application can confuse the user and cause low-memory conditions on a machine with restricted memory. Ideally, the application should be small and non-intrusive.
When writing applications for Windows CE version 1.0, use the function PegRunAppAtTime.