CeRunAppAtEvent

Article
06/30/2006

This function starts running an application when a specified event occurs.

BOOL CeRunAppAtEvent(
TCHAR *pwszAppName, 
LONG lWhichEvent );

Parameters

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

lWhichEvent
[in] Event at which the application is to be started. It is one of the following values:

Value	Description
NOTIFICATION_EVENT_DEVICE_CHANGE	When a PC Card device is changed.
NOTIFICATION_EVENT_NONE	No events — remove all event registrations for this application.
NOTIFICATION_EVENT_RESTORE_END	When a full device data restore completes.
NOTIFICATION_EVENT_RS232_DETECTED	When an RS232 connection is made.
NOTIFICATION_EVENT_SYNC_END	When data synchronization finishes.
NOTIFICATION_EVENT_TIME_CHANGE	When the system time is changed.
NOTIFICATION_EVENT_TZ_CHANGE	When the time zone is changed.
NOTIFICATION_EVENT_WAKEUP	When the device wakes up.

Return Values

TRUE indicates success. FALSE indicates failure.

Remarks

The application is started with a system-defined command line. If there was already an instance of the application running, the new instance must send a private message to the existing instance and then shut down. The command line, which corresponds to the registered event, can be one of the following string constants.

Constant	Value
APP_RUN_AFTER_EXTENDED_EVENT	"AppRunAfterExtendedEvent"
APP_RUN_AFTER_SYNC	"AppRunAfterSync"
APP_RUN_AFTER_TZ_CHANGE	"AppRunAfterTzChange"
APP_RUN_AFTER_WAKEUP	"AppRunAfterWakeup"
APP_RUN_AT_AC_POWER_ON	"AppRunAtAcPowerOn"
APP_RUN_AT_AC_POWER_OFF	"AppRunAtAcPowerOff"
APP_RUN_AT_NET_CONNECT	"AppRunAtNetConnect"
APP_RUN_AT_NET_DISCONNECT	"AppRunAtNetDisconnect"
APP_RUN_AT_DEVICE_CHANGE	"AppRunDeviceChange"
APP_RUN_AT_IR_DISCOVERY	"AppRunAtIrDiscovery"
APP_RUN_AT_RS232_DETECT	"AppRunAtRs232Detect"
APP_RUN_AFTER_RESTORE	"AppRunAfterRestore"

The string values in this table are processed as command line commands. In some cases, the part of the command line that follows the string is treated as a parameter.

Use the CeRunAppAtEvent function 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.

The following constants are defined in the header file, but they are not supported:

NOTIFICATION_EVENT_IR_DISCOVERED

NOTIFICATION_EVENT_NET_CONNECT

NOTIFICATION_EVENT_NET_DISCONNECT

NOTIFICATION_EVENT_OFF_AC_POWER

NOTIFICATION_EVENT_ON_AC_POWER

Requirements

Runs on	Versions	Defined in	Include	Link to
Windows CE OS	1.01 and later	Notify.h		Notify.lib

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

CeRunAppAtTime

Last updated on Tuesday, July 13, 2004

CeRunAppAtEvent

Additional resources