API Reference | developer.brewmp.com API Reference | developer.brewmp.com

Developer

API Reference

ISHELL_STARTBACKGROUNDAPPLET()

Brew Release
Brew MP 1.0.2
See Also
Error Codes Events IShell ISHELL_CreateInstance ISHELL_StartAppletEx ISHELL_BrowseFile ISHELL_BrowseURL
Description
This method is identical to ISHELL_StartAppletArgs with the exception that the specified application is started in the background. In this case, the applet receives the EVT_APP_START_BACKGROUND event instead of the EVT_APP_START event. Calling this function on an application that has already started and is currently in the applet history will fail and return ENOTALLOWED
Params
pIShell
[]:
Pointer to the IShell object.
cls
[]:
32-bit applet class ID.
pszArgs
[]:
ASCIIZ string of arguments to the application.
Interface
  • ISHELL
Prototype
  • int ISHELL_StartBackgroundApplet(IShell *pIShell,AEECLSID cls,const char * pszArgs);
    
Return
  • AEE_SUCCESS: If the applet was created and started. AEE_EALREADY: If another applet is already starting. AEE_EBADCLASS: If the Shell class supplied is invalid. AEE_ENOMEMORY: If insufficient memory. AEE_ECLASSNOTSUPPORT: If the class specified is not supported. AEE_EEXPIRED: If the applet has expired. AEE_EFILENOEXISTS: If The applet has been disabled. AEE_EUNABLETOLOAD: If the OEM won't allow loading this applet. AEE_ENOTALLOWED: This application is already in the applet history and hence cannot be started in the background.
Side Effect
  • A new application history entry will not be created for an applet started in background.
Comments
None