Handling the Local Device Name

How to get and set the local device name

The local device name is read and set through the RHostResolver functions GetHostName() and SetHostName() respectively.

Getting the Local Device Name

The following code shows how to get the local name:

1. Link against the following libraries:

   esock.lib
   bluetooth.lib
   sdpdatabase.lib
   

2. Connect to the socket server

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

3. Create and initialise an RHostResolver

   RHostResolver hr;
   User::LeaveIfError(hr.Open(socketServ,pInfo.iAddrFamily,pInfo.iProtocol));

4. 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 RHostResolver::SetHostName() function.

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

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

• Debugging the Host Controller

• Disconnecting ACL links