Class RSyncMLTransport

class RSyncMLTransport : public RSubSessionBase;

Description

Handle to information about an available SyncML transport.

Derivation

• RSubSessionBase - Client-side handle to a sub-session

• RSyncMLTransport - Handle to information about an available SyncML transport

Members

Defined in RSyncMLTransport:
Close(), DisplayName(), Identifier(), OpenL(), Properties(), RSyncMLTransport(), StartListeningL(), StopListeningL(), SupportsCapability()

Inherited from RSubSessionBase:
CloseSubSession(), CreateAutoCloseSubSession(), CreateSubSession(), Send(), SendReceive(), Session(), SubSessionHandle()

IMPORT_C RSyncMLTransport();

Description

Default constructor.

IMPORT_C void OpenL(RSyncMLSession &, TSmlTransportId);

Description

Opens a handle on the transport identified by aId.

Parameters

RSyncMLSession & An open session with the Sync Agent. TSmlTransportId The ID of the transport to open.

Leave codes

SyncMLError::KErrTransportNotFound The specified transport ID does not represent a valid transport. KErrNoMemory Insufficient system memory to complete the operation. System error codes.

IMPORT_C TSmlTransportId Identifier() const;

Pre-Condition

The handle is open.

Description

Gets the ID of the transport referenced by this handle.

Return value

TSmlTransportId The transport ID.

IMPORT_C const TDesC &DisplayName() const;

Pre-Condition

The handle is open.

Description

Gets the human-readable display name of the transport referenced by this handle.

Return value

const TDesC & The name of the transport.

IMPORT_C TBool SupportsCapability(TSmlTransportCap) const;

Pre-Condition

The handle is open.

Description

Tests if the specified capability is supported.

Parameters

TSmlTransportCap The capability to test support for.

Return value

TBool True if the specified capability is supported.

IMPORT_C const CSyncMLTransportPropertiesArray &Properties() const;

Pre-Condition

The handle is open.

Description

Gets a list of all properties supported by this transport.

Return value

const CSyncMLTransportPropertiesArray &

Capability:

LocalServices

IMPORT_C void StartListeningL() const;

Pre-Condition

The handle is open.

Description

Starts listening for incoming connections on this transport.

Post-Condition

The transport is listening for incoming connections.

Leave codes

KErrNoMemory Insufficient system memory to complete the operation. System error codes.

Capability:

LocalServices

IMPORT_C void StopListeningL() const;

Pre-Condition

The handle is open.

The transport is listening for incoming connections.

Description

Stops listening for incoming connections on this transport.

Post-Condition

The transport is NOT listening for incoming connections.

Leave codes

KErrNoMemory Insufficient system memory to complete the operation. System error codes.

IMPORT_C void Close();

Description

Closes this handle.