Location:
CDBTEMP.H
Link against: commdb.lib
class CCommsDbTemplateRecord : public CBase;
The view on a template record of a specific table.
The view contains only the template record and therefore, unlike the more general CCommsDbTableView
class, does not contain any navigation functions.
This class does, however, contain the necessary member functions for reading and writing to columns.
CBase
- Base class for all classes to be instantiated on the heap
CCommsDbTemplateRecord
- The view on a template record of a specific table
Defined in CCommsDbTemplateRecord
:
CancelModifications()
, Delete()
, GetTableName()
, InsertCopy()
, Modify()
, NewL()
, ReadBoolL()
, ReadColumnLengthL()
, ReadLongTextLC()
, ReadTextL()
, ReadTextL()
, ReadTypeAttribL()
, ReadUintL()
, StoreModifications()
, TemplateRecordExists()
, WriteBoolL()
, WriteLongTextL()
, WriteTextL()
, WriteTextL()
, WriteUintL()
, ~CCommsDbTemplateRecord()
Inherited from CBase
:
Extension_()
,
operator new()
static IMPORT_C CCommsDbTemplateRecord *NewL(CCommsDatabaseBase *aDb, const TDesC &aTableName);
Creates a new template view on the database and table specified.
|
|
IMPORT_C ~CCommsDbTemplateRecord();
Frees all resources owned by this object, prior to its destruction. Specifically, it closes the view.
IMPORT_C TInt Modify();
Modifies the existing template record if there is no template create one. StoreModifications()
is called to complete the transaction.
|
IMPORT_C TInt StoreModifications();
Stores an new or updated template back to the database.
|
Capability: | Dependent | on table, see the guide page referenced below. |
IMPORT_C void ReadTextL(const TDesC &aColumn, TDes8 &aValue);
Reads narrow (ASCII) text located in a specific column within the template record and copies it to the specified 8 bit modifiable descriptor. The column is identified by the name supplied in the descriptor aColumn.
The maximum length of text expected by this function is the value of the constant KCommsDbSvrMaxColumnNameLength. The maximum length of aValue supplied by the caller can, therefore, be the same.
If the template record does not exist, this function will just return with an empty aValue desciptor.
This read operation must not occur if any of the operations involved in changing the template record are still outstanding,
otherwise the function raises a CommsDbServer 10 panic. For example, the panic is raised if this function is called between
calls to Modify()
and StoreModifications()
.
The CommsDbServer 10 panic is also raised if this function is called after the view has been closed.
|
Capability: | Dependent | on table, see the guide page referenced below. |
IMPORT_C void ReadTextL(const TDesC &aColumn, TDes16 &aValue);
Reads wide (UNICODE) text located in a specific column within the template record and copies it to the specified 16 bit modifiable descriptor. The column is identified by the name supplied in the descriptor aColumn.
The maximum length of text expected by this function is the value of the constant KCommsDbSvrMaxColumnNameLength. The maximum length of aValue supplied by the caller can, therefore, be the same.
This read operation must not occur if any of the operations involved in changing the template record are still outstanding,
otherwise the function raises a CommsDbServer 10 panic. For example, the panic is raised if this function is called between
calls to Modify()
and StoreModifications()
.
The CommsDbServer 10 panic is also raised if this function is called after the view has been closed.
If the template record does not exist, this function will just return with an empty aValue desciptor.
|
Capability: | Dependent | on table, see the guide page referenced below. |
IMPORT_C HBufC *ReadLongTextLC(const TDesC &aColumn);
Reads the long text located in a specific column within the template record and copies this text to a heap descriptor. The heap descriptor is allocated and its pointer returned by this function. The column is identified by the name supplied in the descriptor aColumn.
While the text in columns retrieved by the ReadTextL()
functions is limited in length, there is no restriction on the length of long text.
If the template record does not exist, this function will just return an empty desciptor. Also in this case, the caller is still responsible for removing this object from the cleanup stack.
This read operation must not occur if any of the operations involved in changing a record are still outstanding, otherwise
the function raises a CommsDbServer 10 panic. For example, the panic is raised if this function is called between calls to
Modify()
and StoreModifications()
.
The CommsDbServer 10 panic is also raised if this function is called after the view has been closed.
|
|
Capability: | Dependent | on table, see the guide page referenced below. |
IMPORT_C void ReadUintL(const TDesC &aColumn, TUint32 &aValue);
Reads an unsigned integer value located in a specific column within the template record and copies it into the specified unsigned integer. The column is identified by the name supplied in the descriptor aColumn.
This read operation must not occur if any of the operations involved in changing the template record are still outstanding,
otherwise the function raises a CommsDbServer 10 panic. For example, the panic is raised if this function is called between
calls to Modify()
and StoreModifications()
.
The CommsDbServer 10 panic is also raised if this function is called after the view has been closed.
If the template record does not exist then the function leaves with KErrUnknown.
|
Capability: | Dependent | on table, see the guide page referenced below. |
IMPORT_C void ReadBoolL(const TDesC &aColumn, TBool &aValue);
Reads a boolean value located in a specific column within the template record and copies it into the specified descriptor. The column is identified by the name supplied in the descriptor aColumn.
This read operation must not occur if any of the operations involved in changing the template record are still outstanding,
otherwise the function raises a CommsDbServer 10 panic. For example, the panic is raised if this function is called between
calls to Modify()
and StoreModifications()
.
The CommsDbServer 10 panic is also raised if this function is called after the view has been closed.
If the template record does not exist then the function leaves with KErrUnknown.
|
Capability: | Dependent | on table, see the guide page referenced below. |
IMPORT_C void ReadTypeAttribL(const TDesC &aColumn, TDbColType &aColType, TUint32 &aAttrib);
Gets the type and the attributes of a specific column within the template record and puts them into a reference to an object and a reference to an unsigned integer respectively. The column is identified by the name supplied in the descriptor aColumn.
The column type is described by the TDbColType enumerator.
The column attributes are one or more of the values TDbCol::ENotNull
and TDbCol::EAutoIncrement
.
This function must not be called if any of the operations involved in changing the template record are still outstanding,
otherwise the function raises a CommsDbServer 10 panic. For example, the panic is raised if this function is called between
calls to Modify()
and StoreModifications()
.
|
Capability: | Dependent | on table, see the guide page referenced below. |
IMPORT_C void ReadColumnLengthL(const TDesC &aColumn, TInt &aLength);
Gets the length of a specific column within the template record and copies it to an integer passed by the caller. The column is identified by the name supplied in the descriptor aColumn.
This read operation must not occur if any of the operations involved in changing a template record are still outstanding,
otherwise the function raises a CommsDbServer 10 panic. For example, the panic is raised if this function is called between
calls to Modify()
and StoreModifications()
.
The CommsDbServer 10 panic is also raised if this function is called after the view has been closed.
If the template record does not exist, this function will just return with aLength set to zero.
|
Capability: | Dependent | on table, see the guide page referenced below. |
IMPORT_C void WriteTextL(const TDesC &aColumn, const TDesC8 &aValue);
Writes the narrow (ASCII) text from the specified 8 bit descriptor to a specific column within the template record. The column is identified by the name supplied in the descriptor aColumn.
An earlier call to Modify()
must have been made before calling this function otherwise the function raises a CommsDbServer 12 panic.
|
|
Capability: | Dependent | on table, see the guide page referenced below. |
IMPORT_C void WriteTextL(const TDesC &aColumn, const TDesC16 &aValue);
Writes the wide (Unicode) text from the specified 16 bit descriptor to a specific column within the template record. The column is identified by the name supplied in the descriptor aColumn.
An earlier call to Modify()
must have been made before calling this function otherwise the function raises a CommsDbServer 12 panic.
The CommsDbServer 12 panic is also raised if this function is called after the view has been closed.
|
|
Capability: | Dependent | on table, see the guide page referenced below. |
IMPORT_C void WriteLongTextL(const TDesC &aColumn, const TDesC &aValue);
Writes the long text from a specified descriptor to a specific column within the template record. The column is identified by the name supplied in the descriptor aColumn.
An earlier call to Modify()
must have been made before calling this function otherwise the function raises a CommsDbServer 12 panic.
The CommsDbServer 12 panic is also raised if this function is called after the view has been closed.
While the text written by WriteTextL()
functions is limited in length, there is no restriction on the length of long text.
|
|
Capability: | Dependent | on table, see the guide page referenced below. |
IMPORT_C void WriteUintL(const TDesC &aColumn, const TUint32 &aValue);
Writes a specified unsigned integer value to a specific column within the template record. The column is identified by the name supplied in the descriptor aColumn.
An earlier call to Modify()
must have been made before calling this function otherwise the function raises a CommsDbServer 12 panic.
The CommsDbServer 12 panic is also raised if this function is called after the view has been closed.
The column being changed must not be the Id column (symbolic name COMMDB_ID) otherwise the function raises a CommsDbServer 13 panic.
|
|
Capability: | Dependent | on table, see the guide page referenced below. |
IMPORT_C void WriteBoolL(const TDesC &aColumn, const TBool &aValue);
Writes a specified boolean value to a specific column within the template record. The column is identified by the name supplied in the descriptor aColumn.
An earlier call to Modify()
must have been made before calling this function otherwise the function raises a CommsDbServer 12 panic.
The CommsDbServer 12 panic is also raised if this function is called after the view has been closed.
|
|
IMPORT_C void GetTableName(TDes &aTableName) const;
The name of the table that this template belongs to.
|
Capability: | Dependent | on table, see the guide page referenced below. |
IMPORT_C TInt InsertCopy(TUint32 &aId);
Creates a new record based on the contents of the template record
|
|