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)
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.
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.
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)
Provides notification of the result of the discovery of nearby Bluetooth devices and EIR data.
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.
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)
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).
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)
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.
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.