Symbian^3 Application Developer Library >

MBTEngSdpResultReceiver Class Reference

class MBTEngSdpResultReceiver

Class CBTEngDiscovery

Callback interface for receiving results from queries of remote SDP databases. Clients that make SDP queries through CBTEngDiscovery must implement this interface to handle the results.

btengdiscovery.lib
Since
S60 v3.2
Public Member Functions
void AttributeSearchComplete ( TSdpServRecordHandle , const RSdpResultArray &, TInt )
void DeviceSearchComplete ( CBTDevice *, TInt )
IMPORT_C void DeviceSearchComplete ( CBTDevice *, TNameEntry *, TInt )
IMPORT_C void GetEirServiceUUIDsComplete ( TNameEntry *, TInt )
void ServiceAttributeSearchComplete ( TSdpServRecordHandle , const RSdpResultArray &, TInt )
void ServiceSearchComplete (const RSdpRecHandleArray &, TUint , TInt )

Member Functions Documentation

AttributeSearchComplete(TSdpServRecordHandle, const RSdpResultArray &, TInt)

void AttributeSearchComplete ( TSdpServRecordHandle aHandle,
const RSdpResultArray & aAttr,
TInt aErr
) [pure virtual]

Provides notification of the result of an attribute search that matches the requested attribute (through CBTEngDiscovery::RemoteSdpQuery ). This method indicates that the search has completed, and returns all the results to the caller at once.

Since
S60 v3.2

Parameters

TSdpServRecordHandle aHandle Record handle of the service record containing the result.
const RSdpResultArray & aAttr Array containing the attribute that matches the requested attribute. Note: the array will not be available anymore after this method returns.
TInt aErr Error code of the service search operation; KErrNone if sucessful, KErrEof if the requested attribute was not contained in the specified service record, KErrCouldNotConnect and KErrCouldDisconnected in case of Bluetooth connection errors; otherwise one of the system-wide error codes.

DeviceSearchComplete(CBTDevice *, TInt)

void DeviceSearchComplete ( CBTDevice * aDevice,
TInt aErr
) [pure virtual]

Provides notification of the result of the discovery of nearby Bluetooth devices.

Since
S60 v3.2

Parameters

CBTDevice * aDevice The data structure encapsulates information about the selected device. Ownership of the data structure has not been transfered and is still with the API client.
TInt aErr Error code of the device search operation; KErrNone if sucessful, KErrCancel if the user cancelled the dialog, KErrAbort if CBTEngDiscovery::CancelSearchRemoteDevice was called; otherwise one of the system-wide error codes.

DeviceSearchComplete(CBTDevice *, TNameEntry *, TInt)

IMPORT_C void DeviceSearchComplete ( CBTDevice * aDevice,
TNameEntry * aNameEntry,
TInt aErr
) [virtual]

Provides notification of the result of the discovery of nearby Bluetooth devices and EIR data.

Since
S60 v5.1

Parameters

CBTDevice * aDevice The data structure encapsulates information about the selected device. Ownership of the data structure has not been transfered and is still with the API client.
TNameEntry * aNameEntry Contains the EIR data of the remote device. Ownership of the data structure has not been transfered and is still with the API client.
TInt aErr Error code of the device search operation; KErrNone if sucessful, KErrCancel if the user cancelled the dialog, KErrAbort if CBTEngDiscovery::CancelSearchRemoteDevice was called; otherwise one of the system-wide error codes.

GetEirServiceUUIDsComplete(TNameEntry *, TInt)

IMPORT_C void GetEirServiceUUIDsComplete ( TNameEntry * aNameEntry,
TInt aErr
) [virtual]

Provides notification of the result of service UUIDs retrieval.

Since
S60 v5.1

Parameters

TNameEntry * aNameEntry Contains the EIR data of the remote device. Ownership of the data structure has not been transfered and is still with the API client.
TInt aErr KErrNone if sucessful; otherwise one of the system-wide error codes.

ServiceAttributeSearchComplete(TSdpServRecordHandle, const RSdpResultArray &, TInt)

void ServiceAttributeSearchComplete ( TSdpServRecordHandle aHandle,
const RSdpResultArray & aAttr,
TInt aErr
) [pure virtual]

Provides notification of the result of an combination of a service and attribute search (through CBTEngDiscovery::RemoteSdpQuery ). This method is called for each service and attribute combination for which a match was found. The last result (which could be empty if no match was found) contain error code KErrEof to indicate that the search has completed. The corresponding CBTEngDiscovery instance can only be deleted inside the callback method if the serach has completed (KErrEof is received).

Since
S60 v3.2

Parameters

TSdpServRecordHandle aHandle Record handle of the service record containing the result.
const RSdpResultArray & aAttr Array containing the attribute that matches the requested attribute. Note: the array will not be available anymore after this method returns.
TInt aErr Error code of the service search operation; KErrNone if sucessful and more results follow, KErrEof indicates that this is the last result (which could be empty if no match was found), KErrCouldNotConnect and KErrCouldDisconnected in case of Bluetooth connection errors; otherwise one of the system-wide error codes.

ServiceSearchComplete(const RSdpRecHandleArray &, TUint, TInt)

void ServiceSearchComplete ( const RSdpRecHandleArray & aResult,
TUint aTotalRecordsCount,
TInt aErr
) [pure virtual]

Provides notification of the result of a service search that matches the requested UUID (through CBTEngDiscovery::RemoteSdpQuery ). This method indicates that the search has completed, and returns all the results to the caller at once.

Since
S60 v3.2

Parameters

const RSdpRecHandleArray & aResult Array of record handles that match the requested UUID. Note: the array will not be available anymore after this method returns.
TUint aTotalRecordsCount The total number of records returned.
TInt aErr Error code of the service search operation; KErrNone if sucessful, KErrEof if no record matched the requested UUID, KErrCouldNotConnect and KErrCouldDisconnected in case of Bluetooth connection errors; otherwise one of the system-wide error codes.

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.