Developer

API Reference

INETMGR_SetOpt()

Brew Release
Brew MP 1.0.2
See Also
INETMGR_GetOpt() AEEUDPUrgent
Description
This function provides the ability to configure certain network options. It is similar in paradigm to ISOCKET_IOCtl(), but deals more with network-level items able to be configured, rather than socket-level items able to be configured.
Parameters
  • pINetMgr
    []:
    Pointer to the INetMgr Interface to be used to set network options.
  • nOptName
    []:
    Integer identifying which option to set
  • pOptVal
    []:
    Filled with option-specific data
  • nOptSize
    []:
    Size of pOptVal
Interface
INETMGR
Prototype
    int INETMGR_SetOpt
    (
    INetMgr *pINetMgr,
    int nOptName,
    void *pOptVal,
    int nOptSize
    );
Return
SUCCESS: if the option was set EPRIVLEVEL: if access to the option is prohibited by applet privilege EUNSUPPORTED: if nOptName is unknown EBADPARM: if nOptSize is set to a size that does not correspond to the correct option data
other error, depending on the option
Side Effect
Depend on the option. All the above values modify only RAM values, and so they are lost when the device is reset.
Comment
Currently supported option ids are:
  • RLP options: these options are highly device dependent, and as such may not
  • be able to be configured, available, or well-behaved. They are protected by the
  • system privilege level
    • INET_OPT_DEF_RLP3
    • Default RLP settings, pOptVal must be an AEERLP3Cfg

    • INET_OPT_CUR_RLP3
    • Current RLP settings, pOptVal must be an AEERLP3Cfg

    • INET_OPT_PPP_AUTH
    • Set the system's configured PPP authentication credentials (protected by PL_SYSTEM).

    • pOptVal's type is char *, and the format of the inputted string must be: "userid\000passwd\000".

    DDTM option: this options is highly device dependent, and as such may not be able to be configured, available, or well-behaved. It is protected by the system privilege level.
    • INET_OPT_DDTM_PREF
    • Set the data dedicated transmission mode preference, pOptVal is a pointer to boolean

    • INET_OPT_SELECT_NET
    • Select the data network to use. If this option is not set, AEE_NETWORK_DEFAULT will be used

    • INET_OPT_DORMANCY_TIMEOUT
    • Set the packet data dormancy timeout (idle time until mobile dormancy is initiated) for a CDMA network.
    • The default value is set to 30 seconds.
  • Follow