CeRunAppAtTime

This function prompts the system to start running a specified application at a specified time.

BOOL CeRunAppAtTime(
TCHAR *pwszAppName, 
SYSTEMTIME *lpTime ); 

Parameters

• pwszAppName
  [in] Pointer to a null-terminated string that specifies the name of the application to be run.

• lpTime
  [in] Long pointer to a SYSTEMTIME structure that specifies the time when the given application is to be run.

  If this parameter is NULL, the existing run request is deleted and no new request is entered. The deleted run request must have been initiated by a call to CeRunAppAtTime.

Return Values

TRUE indicates success. FALSE indicates failure.

Remarks

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.

Requirements

Note   This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.

See Also

CeRunAppAtEvent

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.