Symbian^3 Application Developer Library >

TBTRegistrySearch Class Reference

class TBTRegistrySearch

Set search criteria on the Bluetooth Registry.

The search logic is "AND", so if device bonded is set, and code set to headsets the search results contain all the bonded headsets in the registry.

Other things can be added to the search criteria e.g. recently used headsets can easil be found by adding in the LastUsed criterion.

Public Member Functions
TBTRegistrySearch ()
TBTRegistrySearch (const TBTRegistrySearch &)
IMPORT_C void FindAddress (const TBTDevAddr &)
IMPORT_C void FindAll ()
IMPORT_C void FindBluetoothName (const TDesC8 &)
IMPORT_C void FindBonded ()
IMPORT_C void FindCoD (const TBTDeviceClass &)
IMPORT_C void FindCoD (const TBTDeviceClass &, TBTDeviceClassSearch )
IMPORT_C void FindCurrentProcessOwned ()
IMPORT_C void FindFriendlyName (const TDesC &)
IMPORT_C void FindSinceSeen (const TTime &)
IMPORT_C void FindSinceUsed (const TTime &)
IMPORT_C void FindTrusted ()
IMPORT_C void FindUiCookie ( TUint32 )
IMPORT_C void FindUiCookie ( TUint32 , TUint32 )
IMPORT_C void Reset ()
IMPORT_C TBTRegistrySearch & operator= (const TBTRegistrySearch &)
Private Member Enumerations
enum TSearchMask {
EAddress  = 0x0001, EBonded  = 0x0002, ETrusted  = 0x0004, ECoD  = 0x0008, ECoDMajorDev  = 0x0010, ECoDMinorDev  = 0x0020, ECoDService  = 0x0040, ELastSeen  = 0x0080, ELastUsed  = 0x0100, EBTName  = 0x0200, EFriendlyName  = 0x0400, EUiCookie  = 0x2000, EProcess  = 0x4000, EAll  = 0x8000, EExtension  = 0x80000000
}
Private Attributes
TPtrC8 iBluetoothName
TUid iCurrentProcessSID
TBTDevAddr iDeviceAddress
TBTDeviceClass iDeviceClass
TPtrC iFriendlyName
TTime iLastSeen
TTime iLastUsed
TUint iSearchMask
TUint32 iUiCookie
TUint32 iUiCookieMask

Constructor & Destructor Documentation

TBTRegistrySearch()

IMPORT_C TBTRegistrySearch ( )

Default constructor

TBTRegistrySearch(const TBTRegistrySearch &)

IMPORT_C TBTRegistrySearch ( const TBTRegistrySearch & aSearch )

Copy Constructor

Parameters

const TBTRegistrySearch & aSearch

Member Functions Documentation

FindAddress(const TBTDevAddr &)

IMPORT_C void FindAddress ( const TBTDevAddr & aAddress )

Add search criterion to search for given device

Parameters

const TBTDevAddr & aAddress address of device to search for

FindAll()

IMPORT_C void FindAll ( )

Add search criterion to search for finding all devices

FindBluetoothName(const TDesC8 &)

IMPORT_C void FindBluetoothName ( const TDesC8 & aName )

Add search criterion to search for devices with some Bluetooth device name

Parameters

const TDesC8 & aName device name to search for Add search criteria of specific Bluetooth name

FindBonded()

IMPORT_C void FindBonded ( )

Add search criterion for bonded devices

FindCoD(const TBTDeviceClass &)

IMPORT_C void FindCoD ( const TBTDeviceClass & aClass )

Add search criterion to search for specific CoD TBTDeviceClass

Parameters

const TBTDeviceClass & aClass The CoD to search

FindCoD(const TBTDeviceClass &, TBTDeviceClassSearch)

IMPORT_C void FindCoD ( const TBTDeviceClass & aClass,
TBTDeviceClassSearch aPref
)

Add search criterion to search for certain classes of device TBTDeviceClass enum TBTDeviceClassSearch

Parameters

const TBTDeviceClass & aClass the device class to search for
TBTDeviceClassSearch aPref describes the type of device search to perform

FindCurrentProcessOwned()

IMPORT_C void FindCurrentProcessOwned ( )

Add search criterion to search for devices added by the current process

FindFriendlyName(const TDesC &)

IMPORT_C void FindFriendlyName ( const TDesC & aName )

Add search criterion to search for devices with some friendly name

Parameters

const TDesC & aName device name to search for

FindSinceSeen(const TTime &)

IMPORT_C void FindSinceSeen ( const TTime & aLastSeen )

Add search criterion to search for devices seen since given date NOTE not currently implemented

Parameters

const TTime & aLastSeen date from which to find devices

FindSinceUsed(const TTime &)

IMPORT_C void FindSinceUsed ( const TTime & aLastUsed )

Add search criterion to search for devices used since given date

Parameters

const TTime & aLastUsed date from which to find devices

FindTrusted()

IMPORT_C void FindTrusted ( )

Add search criterion for trusted devices

FindUiCookie(TUint32)

IMPORT_C void FindUiCookie ( TUint32 aUiCookie )

Add search criterion to search for devices with a particular UI Cookie value.

Parameters

TUint32 aUiCookie The particular UI cookie value to search on.

FindUiCookie(TUint32, TUint32)

IMPORT_C void FindUiCookie ( TUint32 aUiCookie,
TUint32 aUiCookieMask
)

Add search criterion to search for devices with a particular UI Cookie value.

Parameters

TUint32 aUiCookie The particular UI cookie value to search on.
TUint32 aUiCookieMask The mask to indicate which bits of the cookie value are to be searched on.

Reset()

IMPORT_C void Reset ( )

Resets the search criteria

operator=(const TBTRegistrySearch &)

IMPORT_C TBTRegistrySearch & operator= ( const TBTRegistrySearch & aSearch )

Assignment operator

Parameters

const TBTRegistrySearch & aSearch the search pattern to which to assign this

Member Enumerations Documentation

Enum TSearchMask

Enumerators

EAddress = 0x0001
EBonded = 0x0002
ETrusted = 0x0004
ECoD = 0x0008
ECoDMajorDev = 0x0010
ECoDMinorDev = 0x0020
ECoDService = 0x0040
ELastSeen = 0x0080
ELastUsed = 0x0100
EBTName = 0x0200
EFriendlyName = 0x0400
EUiCookie = 0x2000
EProcess = 0x4000
EAll = 0x8000
EExtension = 0x80000000

Member Data Documentation

TPtrC8 iBluetoothName

TPtrC8 iBluetoothName [private]

TUid iCurrentProcessSID

TUid iCurrentProcessSID [private]

TBTDevAddr iDeviceAddress

TBTDevAddr iDeviceAddress [private]

TBTDeviceClass iDeviceClass

TBTDeviceClass iDeviceClass [private]

TPtrC iFriendlyName

TPtrC iFriendlyName [private]

TTime iLastSeen

TTime iLastSeen [private]

TTime iLastUsed

TTime iLastUsed [private]

TUint iSearchMask

TUint iSearchMask [private]

TUint32 iUiCookie

TUint32 iUiCookie [private]

TUint32 iUiCookieMask

TUint32 iUiCookieMask [private]

Copyright ©2010 Nokia Corporation and/or its subsidiary(-ies).
All rights reserved. Unless otherwise stated, these materials are provided under the terms of the Eclipse Public License v1.0.