Class RBTRegistry

class RBTRegistry : public RBTManSubSession;

Description

Creates and opens a subsession on the BT Registry Server for remote devices.

This subsession allows details of remote devices to be updated, modified, examined etc.

Derivation

• RSubSessionBase - Client-side handle to a sub-session

• RBTManSubSession - A subsession for the RBTMan session

• RBTRegistry - Creates and opens a subsession on the BT Registry Server for remote devices

Members

Defined in RBTRegistry:
AddDeviceL(), Close(), CloseView(), CreateView(), ModifyFriendlyDeviceNameL(), Open(), RBTRegistry()

Inherited from RBTManSubSession:
CancelRequest(), iClientServerMsg, iPadding1, iPadding2

Inherited from RSubSessionBase:
CloseSubSession(), CreateAutoCloseSubSession(), CreateSubSession(), Send(), SendReceive(), Session(), SubSessionHandle()

IMPORT_C RBTRegistry();

Description

Default constructor for registry subsession

IMPORT_C TInt Open(RBTRegServ &aSession);

Description

Open a Bluetooth device subsession.

Parameters

RBTRegServ &aSession The BTManager session to which this subsession is to be attached.

Return value

TInt An error code depicting the outcome of the "open".

IMPORT_C void AddDeviceL(const CBTDevice &aDeviceDetails, TRequestStatus &aStatus);

Description

Add device to the registry

Parameters

const CBTDevice &aDeviceDetails reference to CBTDevice of details of device to add TRequestStatus &aStatus reference to client AO's TRequestStatus

Leave codes

OOM

Capability:

LocalServices

IMPORT_C void ModifyFriendlyDeviceNameL(const TBTDevAddr &aAddress, const TDesC &aNewName, TRequestStatus &aStatus);

Description

Modify the friendly name of a device

Parameters

const TBTDevAddr &aAddress The address of the device of which to change the name const TDesC &aNewName The new name (note - not an 8bit descriptor) TRequestStatus &aStatus reference to client AO's TRequestStatus

Leave codes

OOM

Capability:	LocalServices
Capability:	ReadDeviceData	(LocalServices only if link key is not needed)

IMPORT_C void CreateView(const TBTRegistrySearch &aSearch, TRequestStatus &aStatus);

Description

Create a constrained view of devices on the remote device table of the registry server

Parameters

const TBTRegistrySearch &aSearch A search struct with details of devices to contain in result set TRequestStatus &aStatus TRequestStatus supplied by caller

virtual IMPORT_C void Close();

Description

Close the subsession. Removes all server side resources pertaining to this subsession

IMPORT_C TInt CloseView();

Description

Close a previously created view on the registry. Allows an app to use this subsession for other view or non-view operations

Post-Condition

Subsession is left open for further use - eg to create another view, or perform a viewless operation

Return value

TInt Systemwide error