Collapse all Symbian^3 Application Developer Library

RSdpAgent Class Reference

class RSdpAgent

Interface, internal to SDP agent DLL, used for direct prodding of a remote database.

Public Member Functions
	RSdpAgent ()
void	Cancel ()
void	Close ()
void	Connect ( TBTDevAddr , TRequestStatus &)
TBool	IsOpen ()
TInt	Open ( RSdpSession &)
TInt	RetrieveResult ( TDes8 &)
void	SdpAttributeRequestL ( TInt &, TSdpServRecordHandle , TUint16 , CSdpAttrIdMatchList &, const TDesC8 &, TRequestStatus &)
void	SdpSearchRequestL ( TInt &, CSdpAttrValueDES &, TUint16 , const TDesC8 &, TRequestStatus &)
void	SdpSearchRequestL ( TInt &, CSdpSearchPattern &, TUint16 , const TDesC8 &, TRequestStatus &)

Private Attributes
TSDPConnectBuf	iConnectBuf
TBTDevAddr	iDevAddr
RNetDatabase	iNetDb
HBufC8 *	iRequestBuf
TPckg < TInt >	iResultSize

Constructor & Destructor Documentation

RSdpAgent()

RSdpAgent

(

)

Constructer: Set the HBufC pointer iRequestBuf to NULL (This is an 'R' class). Set the TPckg iResultSize to package nothing.

Member Functions Documentation

Cancel()

void

Cancel

(

)

Pass "Cancel" call up to RNetDatabase .

Close()

void

(

)

Free iRequestBuf. Close RNetDatabase .

Connect(TBTDevAddr, TRequestStatus &)

void	Connect	(	TBTDevAddr	aRemoteAddr,
			TRequestStatus &	aStatus
		)

Ask to connect to remote device.

Parameters

TBTDevAddr aRemoteAddr
TRequestStatus & aStatus

IsOpen()

TBool

IsOpen

(

)

Open(RSdpSession &)

TInt

Open

(

RSdpSession &

aSession

)

Open a NetDatabase session on ESock using SDP over Bluetooth.

Parameters

RSdpSession & aSession

RetrieveResult(TDes8 &)

TInt

RetrieveResult

(

TDes8 &

aResult

)

On completion of a service search or attribute request RSdpAgent is sent the size of the response by the server. To obtain the actual result (buffered in the server) a user needs to call this function. NB. This is a synchronous request.

Parameters

TDes8 & aResult

SdpAttributeRequestL(TInt &, TSdpServRecordHandle, TUint16, CSdpAttrIdMatchList &, const TDesC8 &, TRequestStatus &)

void	SdpAttributeRequestL	(	TInt &	aResultSize,
			TSdpServRecordHandle	aHandle,
			TUint16	aMaxAttrByteCount,
			CSdpAttrIdMatchList &	aMatchList,
			const TDesC8 &	aContState,
			TRequestStatus &	aStatus
		)

Ask for an attribute request using an ID match list ( CSdpAttrIdMatchList ). The reply to this function is to send the SIZE of the response back in the aResultSize parameter. Once this is done the user of this class can set up a buffer big enough to collect the response from server side.

Parameters

TInt & aResultSize
TSdpServRecordHandle aHandle
TUint16 aMaxAttrByteCount
CSdpAttrIdMatchList & aMatchList
const TDesC8 & aContState
TRequestStatus & aStatus

SdpSearchRequestL(TInt &, CSdpAttrValueDES &, TUint16, const TDesC8 &, TRequestStatus &)

void	SdpSearchRequestL	(	TInt &	aResultSize,
			CSdpAttrValueDES &	aUUIDList,
			TUint16	aMaxRecCount,
			const TDesC8 &	aContState,
			TRequestStatus &	aStatus
		)

Ask for a service search using a list attribute value ( CSdpAttrValueDES ). THIS FUNCTION SHOULD NEVER BE EXPORTED AS IS...a general list attribute value is open to misuse. The reply to this function is to send the SIZE of the response back in the aResultSize parameter. Once this is done the user of this class can set up a buffer big enough to collect the response from server side.

Parameters

TInt & aResultSize
CSdpAttrValueDES & aUUIDList
TUint16 aMaxRecCount
const TDesC8 & aContState
TRequestStatus & aStatus

SdpSearchRequestL(TInt &, CSdpSearchPattern &, TUint16, const TDesC8 &, TRequestStatus &)

void	SdpSearchRequestL	(	TInt &	aResultSize,
			CSdpSearchPattern &	aUUIDFilter,
			TUint16	aMaxRecCount,
			const TDesC8 &	aContState,
			TRequestStatus &	aStatus
		)

Ask for a service search using a UUID search pattern ( CSdpSearchPattern ). THIS FUNCTION SHOULD MAY BE EXPORTED (UNLIKE THE OTHER "SdpSearchRequestL") AT SOME FUTURE DATE. The reply to this function is to send the SIZE of the response back in the aResultSize parameter. Once this is done the user of this class can set up a buffer big enough to collect the response from server side.