exestartonboot.h

手机开机自运行程序开发包

// ExeStartOnBoot.h
//
// Copyright (c) 2004 Symbian Ltd.  All rights reserved.
//

#ifndef __EXESTARTONBOOT_H
#define __EXESTARTONBOOT_H

#include <e32std.h>

class CServiceStartOnBootDb;


/** Allows services (exes) to be registered to automatically start on boot.

 This class provides an API to specify executable files to be launched 
 following completion of device boot.  The AddServiceL() method should 
 be called during startup of the service's  associated application. The
 Close() method should be called once any adding has been done to free
 up resources. Subsequent calls to AddServiceL() passing in the same 
 path will have no effect once the service has been added.

 Phone users remove services as normal (using appinst) and the service is
 automatically removed from the start-on-boot sequence; no API is provided
 to remove applications from the startup sequence. 

 Services may also be removed from the sequence if there is a problem 
 during the first 3  minutes of device startup, as this <i>may</i> be 
 associated with one of the auto-started services. 
 - Services added since the last successful reboot are removed from the 
 startup  sequence (without user prompt). All the services that have previously
 started-on-boot successfully are then started.
 - If no services have been added since the last successful reboot, the problem
 may (or may not) be in <i>any</i> of the start on boot srevices. Therefore the
 user is asked whether they want to remove all services or continue as normal.

 Following removal of a service for the above reasons, the service would be
 re-added to the start-on-boot sequence by the user explicitly choosing to re-launch
 the associated application.
 
 Notes:
 - Only one instance of an executable will be launched.
 - No command line can be specified
 - Services will be started in the order they were registered, about 30 seconds
   after device boot completes

@publishedAll
@released */

class RServiceStartOnBoot
	{
public:
	IMPORT_C void CreateL();
	IMPORT_C void Close();
//
	IMPORT_C void AddServiceL(const TDesC& aExeFileName);

private:
	CServiceStartOnBootDb* iServiceDb;
	};


#endif