CCeDBRecord::AddProps

This method adds several properties to the record at the same time.

At a Glance

Header file:	Wcedb.h
Platforms:	H/PC 2.0, Palm-size PC, H/PC Pro
Windows CE versions:	2.0 and later

Syntax

BOOL AddProps( CCeDBProp* pPropArray, int nNumProps );

Parameters

pPropArray: Pointer to an array of CCeDBProp objects to be added to the record.
nNumProps: Number of CCeDBProp objects in pPropArray.

Return Values

TRUE indicates that the operation was successful. FALSE indicates that the properties could not be added.

Remarks

When you add properties to a record by using the AddProps method, 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.