Class RNetDatabase

class RNetDatabase : public RSubSessionBase;

Support

Supported from 5.0

Description

Provides an interface to network databases, such as LM-IAS with IrDA, that may be provided by particular protocol modules.

Derivation

Defined in RNetDatabase:
Add(), Add(), Cancel(), Close(), Open(), Query(), Query(), Remove(), Remove()

Inherited from RSubSessionBase:
CloseSubSession(), CreateSubSession(), Send(), SendReceive(), SubSessionHandle(), operator=()

Notes:

• Before making any queries, a connection to a socket server session must be made.
• Each function is available in both synchronous and asynchronous versions.
• A single RNetDatabase can only perform one request of any type at once. A client is panicked if it makes two requests.
• Particular database access services will specify the format of queries and of responses.

TInt Open(RSocketServ& aSocketServer,TUint anAddrFamily,TUint aProtocol);

Description

Initialises a database access service provided by a particular protocol. It must be called before other object functions are used.

Parameters

Return value

void Close();

Description

Closes a database access service. If a service has been opened using Open(), then it should be closed using Close(). This will ensure all associated resources are released.

TInt Query(const TDesC8& aQuery,TDes8& aResult);

Description

Makes a query to the database.

Parameters

Return value

void Query(const TDesC8& aQuery,TDes8& aResult,TRequestStatus& aStat);

Description

Makes a query to the database asynchronously.

Parameters

TInt Add(const TDesC8& anItem);

Description

Adds a record to the database.

Parameters

Return value

void Add(const TDesC8& anItem,TRequestStatus& aStat);

Description

Adds a record to the database asynchronously.

Parameters

TInt Remove(const TDesC8& anItem);

Description

Removes a record from the database.

Parameters

Return value

void Remove(const TDesC8& anItem,TRequestStatus& aStat);

Description

Removes a record from the database asynchronously.

Parameters

void Cancel();

Description

Cancels any outstanding asynchronous calls, which will return with error code KErrCancel.