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

Developer

API Reference

ISHELL_SETPROPERTY()

Brew Release
Brew MP 1.0.2
See Also
Description
This method sets the property data for the underlying module associated with the input class. Note the following:
- Properties set on non-dynamic class modules are not persistent across
handset power cycles/resets.
- Specifying a NULL input buffer will clear the property.

- Properties with the high-order bit set are reserved for use by callers
with system-level privileges.
- Using 0 (zero) for the input AEECLSID (the cls parameter) specifies the currently running application.

If setting a protected property (such as MPROP_SID), then the caller needs to have system-level privileges. For all other properties, the caller must belong to the same group as the class whose property is requested; either the calling applet's classID is the same as cls, or the module that contains the calling applet belongs to the same groupID as cls. This can be done by listing cls as a dependency in the MIF of the calling applet.
Params
po
[]:
Pointer to the IShell object.
cls
[]:
Class of the application to query.
wID
[]:
Property ID. The supported properties
pSrc
[]:
Destination to fill.
wSize
[]:
Size of the buffer.
Interface
  • ISHELL
Prototype
  •    int  ISHELL_SetProperty
       (
       IShell *po,
       AEECLSID cls,
       uint16 wID,
       void * pSrc,
       uint16 wSize
       );
    
Return
  • The value 0 (zero) : Success. No Error.
    Error codes include: AEE_EBADCLASS: The input class was not found. AEE_EPRIVLEVEL: The caller does not have sufficient privileges. AEE_ENOMEMORY: Insufficient memory.
Side Effect
  • None
Comments
None