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

Developer

API Reference

IBTMGR_SETSVCSECURITY()

Brew Release
Brew MP 1.0.2
See Also
BTServiceSecurity IBTMgr_AuthorizeConnReq() IBTMgr_OnConnRequest()
Description
This method sets the minimum security level for a service or group of services.
The service of interest can be specified in several ways: by its service class UUID (i.e. AEEBT_SCU_SERIAL_PORT), by the RFCOMM server channel number, or by L2CAP PSM number. If security is to be enforced on all services over a particular protocol, the protocol UUID should be specified.
To remove the security setting done by a previous IBTMgr_SetSvcSecurity() on the same service, the application needs to call this API with dSecLevel==AEEBT_SEC_NONE.
If the application wishes to be notified when a remote device tries to connect to use the specified service(s), it should register a signal via IBTMgr_OnConnRequest(). If it does not, connection will be accepted automatically. Whether connection request comes to the application or accepted automatically, dSecLevel will be applied to the connection.
Successful operation would generate AEEBTMGR_EV_SET_SVC_SEC_SUCCESS.
Params
po
[in]:
the object
dSecLevel
[in]:
security level
pSvcID
[in]:
service identifier
Return
AEE_SUCCESS
[]:
operation has been scheduled
AEE_EBADPARM
[]:
input pointers are invalid
AEE_EALREADY
[]:
the previous SetSvcSecurity operation hasn't completed
AEE_EITEMBUSY
[]:
another operation is in progress
AEE_EUNSUPPORTED
[]:
service ID method not supported
Interface
Prototype
  •    int IBTMgr_SetSvcSecurity (IBTMgr*                    po,
                                  BTSecurityLevel            dSecLevel,
                                  const BTServiceIdentifier* pSvcID);
    
Side Effect
  • None
Comments
None