RSdpDatabase Class Reference

#include <btsdp.h>

class RSdpDatabase : public RSdpSubSession

Inherits from

RSdpDatabase
- RSdpSubSession

Public Member Functions
	RSdpDatabase()
virtual IMPORT_C void	Close()
IMPORT_C void	CreateServiceRecordL(const TUUID &, TSdpServRecordHandle &)
IMPORT_C void	CreateServiceRecordL(CSdpAttrValueDES &, TSdpServRecordHandle &)
IMPORT_C void	DeleteAttribute(TSdpServRecordHandle, TSdpAttributeID)
IMPORT_C void	DeleteAttributeL(TSdpServRecordHandle, TSdpAttributeID)
IMPORT_C void	DeleteRecord(TSdpServRecordHandle)
IMPORT_C void	DeleteRecordL(TSdpServRecordHandle)
virtual IMPORT_C TInt	Open(RSdp &)
IMPORT_C void	UpdateAttributeL(TSdpServRecordHandle, TSdpAttributeID, CSdpAttrValue &)
IMPORT_C void	UpdateAttributeL(TSdpServRecordHandle, TSdpAttributeID, TUint)
IMPORT_C void	UpdateAttributeL(TSdpServRecordHandle, TSdpAttributeID, const TDesC16 &)
IMPORT_C void	UpdateAttributeL(TSdpServRecordHandle, TSdpAttributeID, const TDesC8 &)

Inherited Functions
	RSubSessionBase::CloseSubSession(TInt)
	RSubSessionBase::CreateAutoCloseSubSession(RSessionBase &,TInt,const TIpcArgs &)
	RSubSessionBase::CreateSubSession(const RSessionBase &,TInt)
	RSubSessionBase::CreateSubSession(const RSessionBase &,TInt,const TIpcArgs &)
	RSubSessionBase::RSubSessionBase()
	RSubSessionBase::Send(TInt)const
	RSubSessionBase::Send(TInt,const TIpcArgs &)const
	RSubSessionBase::SendReceive(TInt)const
	RSubSessionBase::SendReceive(TInt,TRequestStatus &)const
	RSubSessionBase::SendReceive(TInt,const TIpcArgs &)const
	RSubSessionBase::SendReceive(TInt,const TIpcArgs &,TRequestStatus &)const
	RSubSessionBase::Session()const
	RSubSessionBase::SubSessionHandle()const

Detailed Description

Subsession to the SDP through which service records and their attributes can be added, deleted, and updated.

Constructor & Destructor Documentation

RSdpDatabase ( )

IMPORT_C

RSdpDatabase

(

)

Default constructor.

capability: LocalServices

Member Function Documentation

Close ( )

IMPORT_C void

(

)

[virtual]

Reimplemented from RSdpSubSession::Close()

Closes the SDP database subsession.

Any records that have been added during this session will be removed when the session is closed.

capability: LocalServices

CreateServiceRecordL ( const TUUID &, TSdpServRecordHandle & )

IMPORT_C void	CreateServiceRecordL	(	const TUUID &	aUUID,
			TSdpServRecordHandle &	aHandle
		)

Creates a new service record, with a single service class, in the SDP database.

capability: LocalServices

Parameter	Description
aUUID	The service class UUID for the service record
aHandle	On return, the service record handle of the new record

CreateServiceRecordL ( CSdpAttrValueDES &, TSdpServRecordHandle & )

IMPORT_C void	CreateServiceRecordL	(	CSdpAttrValueDES &	aUUIDList,
			TSdpServRecordHandle &	aHandle
		)

Creates a new service record, with multiple service classes, in the SDP database.

capability: LocalServices

Parameter	Description
aUUIDList	The service class attribute of the new record. This should consist of a list of UUIDs of the service classes to which the record belongs. The UUIDs should be ordered from the most derived service class to the base one.
aHandle	On return, the service record handle of the new record

DeleteAttribute ( TSdpServRecordHandle, TSdpAttributeID )

IMPORT_C void	DeleteAttribute	(	TSdpServRecordHandle	aHandle,
			TSdpAttributeID	aAttrID
		)

Delete an attribute from a service record.

capability: LocalServices

Parameter	Description
aHandle	The service record from which to delete the attribute
aAttrID	The ID of the attribute

DeleteAttributeL ( TSdpServRecordHandle, TSdpAttributeID )

IMPORT_C void	DeleteAttributeL	(	TSdpServRecordHandle	aHandle,
			TSdpAttributeID	aAttrID
		)

Delete an attribute from a service record.

capability: LocalServices

DeprecatedUse non-leaving version instead

DeleteRecord ( TSdpServRecordHandle )

IMPORT_C void

DeleteRecord

(

TSdpServRecordHandle

aHandle

)

Deletes a service record.

capability: LocalServices

Parameter	Description
aHandle	Handle of the service record to delete

DeleteRecordL ( TSdpServRecordHandle )

IMPORT_C void

DeleteRecordL

(

TSdpServRecordHandle

aHandle

)

Deletes a service record.

capability: LocalServices

DeprecatedUse non-leaving version instead

Open ( RSdp & )

IMPORT_C TInt

Open

(

RSdp &

aSession

)

[virtual]

Reimplemented from RSdpSubSession::Open(RSdp &)

Opens a SDP database subsession.

capability: LocalServices

Parameter	Description
aSession	SDP database session

Returns: System-wide error code

UpdateAttributeL ( TSdpServRecordHandle, TSdpAttributeID, CSdpAttrValue & )

IMPORT_C void	UpdateAttributeL	(	TSdpServRecordHandle	aHandle,
			TSdpAttributeID	aAttrID,
			CSdpAttrValue &	aAttrValue
		)

Updates a service record attribute (value encapsulated in a CSdpAttrValue).

If the attribute does not exist, it is created. If it already exists, the current definition is removed and the new value inserted.

No check is made that the attribute value is suitable for the service class to which the record belongs. It is up to the user to ensure that the semantics of the attribute defined by the service class are respected.

capability: LocalServices

Parameter	Description
aHandle	The service record handle to update
aAttrID	The attribute ID to update
aAttrValue	The attribute value

UpdateAttributeL ( TSdpServRecordHandle, TSdpAttributeID, TUint )

IMPORT_C void	UpdateAttributeL	(	TSdpServRecordHandle	aHandle,
			TSdpAttributeID	aAttrID,
			TUint	aUintValue
		)

Updates a service record attribute (integer value).

If the attribute does not exist, it is created. If it already exists, the current definition is removed and the new value inserted.

capability: LocalServices

Parameter	Description
aHandle	The service record handle to update
aAttrID	The attribute ID to update
aUintValue	The attribute value

UpdateAttributeL ( TSdpServRecordHandle, TSdpAttributeID, const TDesC16 & )

IMPORT_C void	UpdateAttributeL	(	TSdpServRecordHandle	aHandle,
			TSdpAttributeID	aAttrID,
			const TDesC16 &	aDesCValue
		)

Updates a service record attribute (wide descriptor value).

If the attribute does not exist, it is created. If it already exists, the current definition is removed and the new value inserted.

capability: LocalServices Updates a service record attribute (narrow descriptor value).

If the attribute does not exist, it is created. If it already exists, the current value is removed and the new value inserted.

capability: LocalServices

Parameter	Description
aHandle	The service record handle to update
aAttrID	The attribute ID to update
aDesCValue	The attribute value

UpdateAttributeL ( TSdpServRecordHandle, TSdpAttributeID, const TDesC8 & )

IMPORT_C void	UpdateAttributeL	(	TSdpServRecordHandle	aHandle,
			TSdpAttributeID	aAttrID,
			const TDesC8 &	aDesCValue
		)

Updates a service record attribute (wide descriptor value).

If the attribute does not exist, it is created. If it already exists, the current value is removed and the new value inserted.

capability: LocalServices Updates a service record attribute (narrow descriptor value).

If the attribute does not exist, it is created. If it already exists, the current definition is removed and the new value inserted.

capability: LocalServices

Parameter	Description
aHandle	The service record handle to update
aAttrID	The attribute ID to update
aDesCValue	The attribute value