CCeDBRecord::AddProps

This member function adds several properties to the record at the same time.

Syntax

BOOL AddProps( CCeDBProp* pPropArray, int nNumProps );

At a Glance

Header file: Wcedb.h
Platforms:
Versions: 2.0 and later

Parameters

pPropArray
A pointer to an array of CCeDBProp objects to be added to the record.
nNumProps
The number of CCeDBProp objects in pPropArray.

Return Values

TRUE if the operation was successful; FALSE if the properties could not be added.

Remarks

When you add propertie to a record by using the AddProps function, the CCeDBRecord object keeps pointers to the properties you pass in. It does not make copies of the properties themselves. When the record is destroyed, it does not release the memory occupied by the properties you added. By contrast, when you read a record from the object store by calling ReadCurrentRecord, the properties in that record are owned by the record, and are consequently freed when the record is destroyed.

See Also

CCeDBRecord Overview, CCeDBRecord Member Functions, Windows CE Database Support, CCeDBProp, CCeDBRecord::AddProp