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

Developer

API Reference

IAPPLETCTL_STOPEX()

Brew Release
Brew MP 1.0.2
See Also
AEEEvent AEE Privilege Levels Applet Events Basic error codes IAppletCtl AEECLSID_AppCloseErrorLog IAppletCtl_Stop() IAppletCtl_Start() IAppletCtl_Terminate()
Description
This method behaves much like IAppletCtl_Stop, but it also allows an error code to be reported to the system as a reason for stopping the applet. This would be useful for app managers or other services/applets, as they can use the AppCloseErrorLog class to listen for such error codes and determine why an applet stopped itself unexpectedly.
Params
pIAppletCtl
[]:
[in] Pointer to the IAppletCtl Interface object.
cls
[]:
[in] class ID of a currently running applet.
errCode
[]:
[in] Error code specifying the reason for stopping.
Interface
Prototype
  •     int IAppletCtl_StopEx
        (
        IAppletCtl *pIAppletCtl,
        AEECLSID cls,
        AEEResult errCode
        );
    
Return
  • AEE_SUCCESS: if successful. EBADCLASS: If specified, cls is not an existing applet, or is an applet that is not loaded. EPRIVLEVEL: The caller doesn't have privileges to perform this operation.
Side Effect
  • The top-visibile application may change.
Comments
None.