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(const CBTDevice &,TRequestStatus &)Add device to the registry
• Close()Close the subsession. Removes all server side resources pertaining to this subse...
• CloseView()Close a previously created view on the registry. Allows an app to use this subse...
• CreateView(const TBTRegistrySearch &,TRequestStatus &)Create a constrained view of devices on the remote device table of the registry ...
• ModifyFriendlyDeviceNameL(const TBTDevAddr &,const TDesC &,TRequestStatus &)Modify the friendly name of a device
• Open(RBTRegServ &)Open a Bluetooth device subsession.
• RBTRegistry()Default constructor for registry subsession

Inherited from RBTManSubSession:

• CancelRequest(TRequestStatus &)Cancel an outstanding request on btmanserver
• iClientServerMsg
• iPadding1
• iPadding2

Inherited from RSubSessionBase:

• CloseSubSession(TInt)Closes the sub-session.
• CreateAutoCloseSubSession(RSessionBase &,TInt,const TIpcArgs &)Creates a new sub-session within an existing session. The new sub-session takes ...
• CreateSubSession(const RSessionBase &,TInt)Creates a new sub-session within an existing session.
• CreateSubSession(const RSessionBase &,TInt,const TIpcArgs &)Creates a new sub-session within an existing session.
• Send(TInt)constSends a blind message to the server - no reply is expected.
• Send(TInt,const TIpcArgs &)constSends a blind message to the server - no reply is expected.
• SendReceive(TInt)constSends a message to the server and waits synchronously for a reply.
• SendReceive(TInt,TRequestStatus &)constSends a message to the server and waits asynchronously for the reply.
• SendReceive(TInt,const TIpcArgs &)constSends a message to the server and waits synchronously for a reply.
• SendReceive(TInt,const TIpcArgs &,TRequestStatus &)constSends a message to the server and waits asynchronously for the reply.
• Session()constReturns a copy of the session associated with this sub-session.
• SubSessionHandle()constGets the sub-session handle number.

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 TDesC16 &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

IMPORT_C virtual 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