Click to Rate and Give Feedback
MSDN
MSDN Library
GWES Reference
Notify Reference
Notify Functions
 CeRunAppAtTime

  Switch on low bandwidth view
CeRunAppAtTime
Windows Mobile SupportedWindows Embedded CE Supported
8/28/2008

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


BOOL CeRunAppAtTime(
  TCHAR* pwszAppName, 
  SYSTEMTIME* lpTime 
); 
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 local 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.

TRUE indicates success. FALSE indicates failure.

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.

If the specified time falls within the platform-dependent period defined by the accuracy of the real-time clock (RTC), the notification is scheduled immediately. The accuracy can be retrieved using IOCTL_KLIB_GETALARMRESOLUTION and ranges from 1 to 60 seconds. If the system does not implement IOCTL_KLIB_GETALARMRESOLUTION, the default RTC accuracy of 10 seconds is assumed.

Headernotify.h
Librarycoredll.lib
Windows Embedded CEWindows CE 1.0 and later
Windows MobileWindows Mobile Version 5.0 and later
Tags What's this?: Add a tag
Community Content   What is Community Content?
Add new content RSS  Annotations
Using CeRunAppAtTime to Signal Events      Joel Ivory Johnson   |   Edit   |   Show History

CeRunAppAtTime can also be used to signal named objects. Within notify.h the string constant NAMED_EVENT_PREFIX_TEXT is defined (along with the numeric constant NAMED_EVENT_PREFIX_LEN, which defines its length). Build a string that is composed the name of the named object to be signaled appended to this constant and pass the result in the parameter pwszAppName and CeRunAppAtTime will signal events instead of running an application.

Flag as ContentBug
Processing
© 2009 Microsoft Corporation. All rights reserved. Terms of Use  |  Trademarks  |  Privacy Statement
Page view tracker