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(TBool)Adds a Boolean element.
• BuildDEAL()Adds a (header for a) Data element alternative (DEA), a data element whose data ...
• BuildDESL()Adds a (header for a) Data element sequence (DES), a data element whose data fie...
• BuildIntL(const TDesC8 &)Adds a signed integer element.
• BuildNilL()Adds a null element.
• BuildStringL(const TDesC8 &)Adds a Text String element.
• BuildURLL(const TDesC8 &)Adds a URL element.
• BuildUUIDL(const TUUID &)Adds a UUID element.
• BuildUintL(const TDesC8 &)Adds an unsigned integer element.
• BuildUnknownL(TUint8,TUint8,const TDesC8 &)Adds an element of any type.
• EndListL()Indicates that subsequent elements no longer belong to current DES or DEA
• MSEB_ExtensionInterfaceL(TUid,void *&)Returns a null aObject if the extension is not implemented, or a pointer to anot...
• StartListL()Indicates that subsequent elements added belong to a DES or DEA.

See also:

• CSdpAgent::AttributeRequestL(TSdpServRecordHandle,TSdpAttributeID)Gets the specified attribute for a remote service.

IMPORT_C virtual 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

IMPORT_C virtual MSdpElementBuilder* BuildNilL();

Description

Adds a null element.

Return value

MSdpElementBuilder * Builder with added element

IMPORT_C virtual 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

IMPORT_C virtual 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

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

Description

Adds a UUID element.

Parameters

const TUUID &aUUID Element to add

Return value

MSdpElementBuilder * Builder with added element

IMPORT_C virtual MSdpElementBuilder* BuildBooleanL(TBool aBool);

Description

Adds a Boolean element.

Parameters

TBool aBool Element to add

Return value

MSdpElementBuilder * Builder with added element

IMPORT_C virtual 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

IMPORT_C virtual 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 MSdpElementBuilder::StartListL(), and then calls to add elements to the list.

Return value

MSdpElementBuilder * Attribute value with added element

IMPORT_C virtual 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 MSdpElementBuilder::StartListL(), and then calls to add elements to the list.

Return value

MSdpElementBuilder * Attribute value with added element

IMPORT_C virtual 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

IMPORT_C virtual 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

IMPORT_C virtual 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