PrevNextUpHome SophiaFramework UNIVERSE 5.3
SFBBTMgr
Wrapper Class for the IBTMgr interface.
#include <SFBBTMgr.h.hpp>
class SFBBTMgr : public SFBQuery;
SFMTYPEDEFWRAPPER(SFBBTMgr)

Inheritance diagram

 Inheritance diagram of SFBBTMgrClass

Version

BREW 2.0 BREW 2.1 BREW 3.1 BREW 4.0
X X O O

Reference

BREW API IBTMgr

Member

Public Functions
SFCError AuthorizeConnReq( BDAddress const * address , BTServiceIdentifier const * identifier , Bool authorize )
Accept or reject connection request from the given remote device which is attempting to use a service on the given protocol.
SFCError DisableRadio( Void )
Cause Bluetooth radio to be powered off.
SFCError DisableVisibility( Void )
Cause Bluetooth radio to be undetectable by remote devices.
SFCError EnableRadio( Void )
Cause Bluetooth radio to be powered on.
SFCError GetConnRequest( BDAddress * address , BTServiceIdentifier * identifier )
Retrieve the request information.
SFCError GetEvent( BTMgrEventType * eventID , BTResult * result )
Retrieve BTMgr events.
SFCError GetLocalSettings( BTLocalSettingBitmap * bitmap , BTLocalSettings * setting )
Retrieve the local Bluetooth device's current settings.
SFCError GetRadioState( BTRadioState * radioState )
Retrieves the local Bluetooth device's current radio state.
static
SFBBTMgrSmp
NewInstance( SFCErrorPtr exception = null )
Create a new SFBBTMgr instance.
static
SFBBTMgrSmp
NewInstance( AEECLSID id , SFCErrorPtr exception = null )
Create a new SFBBTMgr instance.
SFCError OnConnRequest( SFBSignalSmpConstRef signal )
Allow application to register to be notified when a remote device tries to bring up a connection to use a service set to be protected via SetSvcSecurity().
SFCError OnEventNotify( SFBSignalSmpConstRef signal )
Register a signal to be triggered when the object has one or more events for application.
SFCError RestoreVisibility( Void )
Return the local device's Bluetooth radio to its settings that was previously overriden by DisableVisibility().
SFCError SetBlockedDevList( SInt32 num , BDAddress const * addressList )
Provide the underlying Bluetooth driver with a list of BD addresses of devices to be blocked.
SFCError SetCoD( BTClassOfDevice const * cod )
Set the Bluetooth Class of Device (CoD) for the local device.
SFCError SetName( UInt08ConstPtr name )
Set the Bluetooth name of local device.
SFCError SetPrefConnRole( Bool master )
Set the preferred connection role for the local device in future connections initiated by remote devices.
SFCError SetRoleSwitchPolicy( Bool allow )
Set the role switch policy.
SFCError SetSecurity( BTSecurityLevel security )
Set the minimum level of security that should be applied in all future connections regardless of services.
SFCError SetSvcSecurity( BTSecurityLevel security , BTServiceIdentifier const * identifier )
Set the minimum security level for a service or group of services.
SFCError TuneScanPerformance( BTActVsPwr pageScanParam , BTActVsPwr inquiryScanParam )
Set the performance parameters used in page scanning and inquiry scanning.
SFCError QueryInterface( AEECLSID clsid , VoidHandle handle ) (inherits from SFBQuery)
Ask an object for another API contract from the object in question.
SFCError QueryInterface( AEECLSID clsid , SFBBaseSmpPtr handle ) (inherits from SFBQuery)
Ask an object for another API contract from the object in question.
SFBBaseSmp QueryInterface( AEECLSID clsid ) (inherits from SFBQuery)
Ask an object for another API contract from the object in question.
Void Self( AEECLSID clsidReq , SFBQuerySmpPtr clone , AEECLSID clsidImp ) (inherits from SFBQuery)
Helper macro for those implementing an object with a single interface.
SFBQuerySmp Self( AEECLSID clsidReq , AEECLSID clsidImp ) (inherits from SFBQuery)
Helper macro for those implementing an object with a single interface.
Protected Functions
static
SFBBaseSmp
FactoryByCreate( AEECLSID id , SFCErrorPtr exception = null ) (inherits from SFBBase)
Create the instance for the specified ClassID's interface.
static
SFBBaseSmp
FactoryByQuery( SFBQuerySmpConstRef query , AEECLSID id , SFCErrorPtr exception = null ) (inherits from SFBBase)
Create the instance for the specified ClassID's interface using the SFBQuery instance.

SFBBTMgr::AuthorizeConnReq
Accept or reject connection request from the given remote device which is attempting to use a service on the given protocol.
[ public ]
SFCError AuthorizeConnReq(
    BDAddress const * address                // address of requesting device
    BTServiceIdentifier const * identifier   // requested service
    Bool authorize                           // true to accept the request; false to reject
);

Reference

BREW API IBTMgr_AuthorizeConnReq


SFBBTMgr::DisableRadio
Cause Bluetooth radio to be powered off.
[ public ]
SFCError DisableRadio(Void);

Reference

BREW API IBTMgr_DisableRadio


SFBBTMgr::DisableVisibility
Cause Bluetooth radio to be undetectable by remote devices.
[ public ]
SFCError DisableVisibility(Void);

Reference

BREW API IBTMgr_DisableVisibility


SFBBTMgr::EnableRadio
Cause Bluetooth radio to be powered on.
[ public ]
SFCError EnableRadio(Void);

Reference

BREW API IBTMgr_EnableRadio


SFBBTMgr::GetConnRequest
Retrieve the request information.
[ public ]
SFCError GetConnRequest(
    BDAddress * address                // address of requesting device
    BTServiceIdentifier * identifier   // requested service
);

Reference

BREW API IBTMgr_GetConnRequest


SFBBTMgr::GetEvent
Retrieve BTMgr events.
[ public ]
SFCError GetEvent(
    BTMgrEventType * eventID   // one of the event IDs
    BTResult * result          // only valid for event representing failure operation
);

Reference

BREW API IBTMgr_GetEvent


SFBBTMgr::GetLocalSettings
Retrieve the local Bluetooth device's current settings.
[ public ]
SFCError GetLocalSettings(
    BTLocalSettingBitmap * bitmap   // bitmask of the valid fields
    BTLocalSettings * setting       // current local setttings
);

Reference

BREW API IBTMgr_GetLocalSettings


SFBBTMgr::GetRadioState
Retrieves the local Bluetooth device's current radio state.
[ public ]
SFCError GetRadioState(
    BTRadioState * radioState   // local radio state
);

Reference

BREW API IBTMgr_GetRadioState


SFBBTMgr::NewInstance
Create a new SFBBTMgr instance.
[ public, static ]
SFBBTMgrSmp NewInstance(
    SFCErrorPtr exception = null   // Error
);
[ public, static ]
SFBBTMgrSmp NewInstance(
    AEECLSID id                    // Class ID
    SFCErrorPtr exception = null   // Error
);

SFBBTMgr::OnConnRequest
Allow application to register to be notified when a remote device tries to bring up a connection to use a service set to be protected via SetSvcSecurity().
[ public ]
SFCError OnConnRequest(
    SFBSignalSmpConstRef signal   // signal associated with function to be invoked when user authorization is required
);

Reference

BREW API IBTMgr_OnConnRequest


SFBBTMgr::OnEventNotify
Register a signal to be triggered when the object has one or more events for application.
[ public ]
SFCError OnEventNotify(
    SFBSignalSmpConstRef signal   // signal associated with the callback function
);

Reference

BREW API IBTMgr_OnEventNotify


SFBBTMgr::RestoreVisibility
Return the local device's Bluetooth radio to its settings that was previously overriden by DisableVisibility().
[ public ]
SFCError RestoreVisibility(Void);

Reference

BREW API IBTMgr_RestoreVisibility


SFBBTMgr::SetBlockedDevList
Provide the underlying Bluetooth driver with a list of BD addresses of devices to be blocked.
[ public ]
SFCError SetBlockedDevList(
    SInt32 num                      // number of address in list; 0 to remove existing list
    BDAddress const * addressList   // addresses of devices to be blocked
);

Reference

BREW API IBTMgr_SetBlockedDevList


SFBBTMgr::SetCoD
Set the Bluetooth Class of Device (CoD) for the local device.
[ public ]
SFCError SetCoD(
    BTClassOfDevice const * cod   // the Class of Device
);

Reference

BREW API IBTMgr_SetCoD


SFBBTMgr::SetName
Set the Bluetooth name of local device.
[ public ]
SFCError SetName(
    UInt08ConstPtr name   // local device name in UTF-8
);

Reference

BREW API IBTMgr_SetName


SFBBTMgr::SetPrefConnRole
Set the preferred connection role for the local device in future connections initiated by remote devices.
[ public ]
SFCError SetPrefConnRole(
    Bool master   // true if local device prefers to be master in connection; false if it prefers to be slave
);

Reference

BREW API IBTMgr_SetPrefConnRole


SFBBTMgr::SetRoleSwitchPolicy
Set the role switch policy.
[ public ]
SFCError SetRoleSwitchPolicy(
    Bool allow   // true if role switch should be allowed; false if disallowed
);

Reference

BREW API IBTMgr_SetRoleSwitchPolicy


SFBBTMgr::SetSecurity
Set the minimum level of security that should be applied in all future connections regardless of services.
[ public ]
SFCError SetSecurity(
    BTSecurityLevel security   // the minimum security level to be used on all connections
);

Reference

BREW API IBTMgr_SetSecurity


SFBBTMgr::SetSvcSecurity
Set the minimum security level for a service or group of services.
[ public ]
SFCError SetSvcSecurity(
    BTSecurityLevel security                 // security level
    BTServiceIdentifier const * identifier   // service identifier
);

Reference

BREW API IBTMgr_SetSvcSecurity


SFBBTMgr::TuneScanPerformance
Set the performance parameters used in page scanning and inquiry scanning.
[ public ]
SFCError TuneScanPerformance(
    BTActVsPwr pageScanParam      // performance parameter for page scanning
    BTActVsPwr inquiryScanParam   // performance parameter for inquiry scanning
);

Reference

BREW API IBTMgr_TuneScanPerformance