Collapse all Symbian^3 Application Developer Library

RSdpDatabase Class Reference

class RSdpDatabase : public RSdpSubSession

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

Inherits from

RSdpDatabase
- RSdpSubSession
  - RSubSessionBase

Public Member Functions
	RSdpDatabase ()
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 )
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

Private Attributes
HBufC8 *	iBuffer
TUint32	iPadding1
TUint32	iPadding2

Constructor & Destructor Documentation

RSdpDatabase()

IMPORT_C

RSdpDatabase

(

)

Default constructor.

capability: LocalServices

Member Functions Documentation

Close()

IMPORT_C void

(

)

[virtual]

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

Parameters

const TUUID & aUUID	The service class UUID for the service record
TSdpServRecordHandle & 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

Parameters

CSdpAttrValueDES & 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.
TSdpServRecordHandle & 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

Parameters

TSdpServRecordHandle aHandle	The service record from which to delete the attribute
TSdpAttributeID 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

Use non-leaving version instead RSdpDatabase::DeleteAttribute

Parameters

TSdpServRecordHandle aHandle	The service record from which to delete the attribute
TSdpAttributeID aAttrID	The ID of the attribute

DeleteRecord(TSdpServRecordHandle)

IMPORT_C void

DeleteRecord

(

TSdpServRecordHandle

aHandle

)

Deletes a service record.

capability: LocalServices

Parameters

TSdpServRecordHandle aHandle

Handle of the service record to delete

DeleteRecordL(TSdpServRecordHandle)

IMPORT_C void

DeleteRecordL

(

TSdpServRecordHandle

aHandle

)

Deletes a service record.

capability: LocalServices

Use non-leaving version instead RSdpDatabase::DeleteRecord

Parameters

TSdpServRecordHandle aHandle

Handle of the service record to delete

Open(RSdp &)

IMPORT_C TInt

Open

(

RSdp &

aSession

)

[virtual]

Opens a SDP database subsession.

capability: LocalServices

Parameters

RSdp & aSession

SDP database session

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

Parameters

TSdpServRecordHandle aHandle	The service record handle to update
TSdpAttributeID aAttrID	The attribute ID to update
CSdpAttrValue & 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

Parameters

TSdpServRecordHandle aHandle	The service record handle to update
TSdpAttributeID aAttrID	The attribute ID to update
TUint 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

Parameters

TSdpServRecordHandle aHandle	The service record handle to update
TSdpAttributeID aAttrID	The attribute ID to update
const TDesC16 & 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

Parameters

TSdpServRecordHandle aHandle	The service record handle to update
TSdpAttributeID aAttrID	The attribute ID to update
const TDesC8 & aDesCValue	The attribute value

Member Data Documentation

HBufC8 * iBuffer

HBufC8 *

iBuffer

[private]

TUint32 iPadding1

TUint32

iPadding1

[private]

TUint32 iPadding2

TUint32

iPadding2

[private]