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 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);
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.