CCeDBRecord::AddProp

This method adds a property to the record.

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 AddProp( CCeDBProp* pProp );

Parameters

pProp
Pointer to the CCeDBProp object to be added.

Return Values

TRUE indicates that the operation was successful. FALSE indicates there was not enough memory available to add the property.

Remarks

When you add a property to a record by using the AddProp method, the CCeDBRecord object keeps a pointer to the property you pass in. It does not make a copy of the property itself. When the record is destroyed, it does not release the memory occupied by that property. 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

CCeDBProp, CCeDBRecord::AddProps