Class MSdpElementBuilder

class MSdpElementBuilder;

Description

Constructs an attribute value, or a set of attributes, from multiple data elements.

The builder interface is used for building single attribute values, and sets of attribute value, attribute ID pairs, as for example in a service record.

In particular, the builder interface can be implemented to receive the results from CSdpAgent attribute queries.

Each member function itself returns an MSdpElementBuilder interface that can then be used to add further elements.

For more on the format of attribute values, see [BS1 Service Discovery Protocol 3].

Note that the interface defines each function to leave with the error KErrGeneral.

Members

Defined in MSdpElementBuilder:
BuildBooleanL(), BuildDEAL(), BuildDESL(), BuildIntL(), BuildNilL(), BuildStringL(), BuildURLL(), BuildUUIDL(), BuildUintL(), BuildUnknownL(), EndListL(), MSEB_ExtensionInterfaceL(), StartListL()

See also:

• CSdpAgent::AttributeRequestL()

virtual IMPORT_C MSdpElementBuilder *BuildUnknownL(TUint8 aType, TUint8 aSizeDesc, const TDesC8 &aData);

Description

Adds an element of any type.

Parameters

TUint8 aType Type descriptor TUint8 aSizeDesc Size descriptor const TDesC8 &aData Data field

Return value

MSdpElementBuilder * Builder with added element

virtual IMPORT_C MSdpElementBuilder *BuildNilL();

Description

Adds a null element.

Return value

MSdpElementBuilder * Builder with added element

virtual IMPORT_C MSdpElementBuilder *BuildUintL(const TDesC8 &aUint);

Description

Adds an unsigned integer element.

Parameters

const TDesC8 &aUint Element to add

Return value

MSdpElementBuilder * Builder with added element

virtual IMPORT_C MSdpElementBuilder *BuildIntL(const TDesC8 &aInt);

Description

Adds a signed integer element.

Parameters

const TDesC8 &aInt Element to add

Return value

MSdpElementBuilder * Builder with added element

virtual IMPORT_C MSdpElementBuilder *BuildUUIDL(const TUUID &aUUID);

Description

Adds a UUID element.

Parameters

const TUUID &aUUID Element to add

Return value

MSdpElementBuilder * Builder with added element

virtual IMPORT_C MSdpElementBuilder *BuildBooleanL(TBool aBool);

Description

Adds a Boolean element.

Parameters

TBool aBool Element to add

Return value

MSdpElementBuilder * Builder with added element

virtual IMPORT_C MSdpElementBuilder *BuildStringL(const TDesC8 &aString);

Description

Adds a Text String element.

Parameters

const TDesC8 &aString Element to add

Return value

MSdpElementBuilder * Builder with added element

virtual IMPORT_C MSdpElementBuilder *BuildDESL();

Description

Adds a (header for a) Data element sequence (DES), a data element whose data field is a sequence of data elements.

This should be followed by a call to StartListL(), and then calls to add elements to the list.

Return value

MSdpElementBuilder * Attribute value with added element

virtual IMPORT_C MSdpElementBuilder *BuildDEAL();

Description

Adds a (header for a) Data element alternative (DEA), a data element whose data field is a sequence of data elements from which one data element is to be selected.

This should be followed by a call to StartListL(), and then calls to add elements to the list.

Return value

MSdpElementBuilder * Attribute value with added element

virtual IMPORT_C MSdpElementBuilder *StartListL();

Description

Indicates that subsequent elements added belong to a DES or DEA.

The end of the list should be indicated by a call to EndList().

Return value

MSdpElementBuilder * Builder

virtual IMPORT_C MSdpElementBuilder *EndListL();

Description

Indicates that subsequent elements no longer belong to current DES or DEA

Building of current DES or DEA is terminated.

Return value

MSdpElementBuilder * Builder

virtual IMPORT_C MSdpElementBuilder *BuildURLL(const TDesC8 &aURL);

Description

Adds a URL element.

Parameters

const TDesC8 &aURL Element to add

Return value

MSdpElementBuilder * Builder with added element

IMPORT_C void MSEB_ExtensionInterfaceL(TUid aInterface, void *&aObject);

Description

Returns a null aObject if the extension is not implemented, or a pointer to another interface if it is.

Parameters

TUid aInterface UID of the interface to return void *&aObject the container for another interface as specified by aInterface