Handling the Local Device Name

Each Bluetooth device has a name for identifying the device to users or applications. This document shows you how to get or set device names.

How to get and set the local device name

The local device name is read and set through the [[[ERROR: [NOKX000E] Unable to find definition for key reference 'RHostResolver']]]RHostResolver functions [[[ERROR: [NOKX000E] Unable to find definition for key reference 'RHostResolver']]]GetHostName() and [[[ERROR: [NOKX000E] Unable to find definition for key reference 'RHostResolver']]]SetHostName() respectively.

Getting the Local Device Name

The following code shows how to get the local name:

Link against the following libraries:

esock.lib
bluetooth.lib
sdpdatabase.lib

Connect to the socket server

RSocketServ socketServ;
User::LeaveIfError(socketServ.Connect());
TProtocolDesc pInfo;
_LIT(KL2Cap, "L2CAP");
User::LeaveIfError(socketServ.FindProtocol(KL2Cap,pInfo));

Create and initialise an [[[ERROR: [NOKX000E] Unable to find definition for key reference 'RHostResolver']]]RHostResolver
```
RHostResolver hr;
User::LeaveIfError(hr.Open(socketServ,pInfo.iAddrFamily,pInfo.iProtocol));
```

Get the local device name

THostName name;
TInt ret=hr.GetHostName(name);

Setting the Local Device Name

Setting the device name differs only in the final step, where you will use the [[[ERROR: [NOKX000E] Unable to find definition for key reference 'RHostResolver']]]RHostResolver::SetHostName() function.

_LIT(KDeviceName,"myDeviceName");
TInt ret=hr.SetHostName(KDeviceName);

Note:

THostName is a descriptor buffer of a suitable minimum size.

Where Next?

This tutorial set takes you through all the steps involved in setting up and communicating over a Bluetooth connection.

Listening for Incoming Bluetooth Connections
Handling the Local Device Name - This document
Performing Low-level Configuration
Disconnecting ACL links