PrevNextUpHome SophiaFramework UNIVERSE 5.3
SFBPimRecordStore
Wrapper Class for the pim_IRecordStore interface.
#include <SFBPimRecordStore.h.hpp>
class SFBPimRecordStore : public SFBQuery;
SFMTYPEDEFWRAPPER(SFBPimRecordStore)

Inheritance diagram

 Inheritance diagram of SFBPimRecordStoreClass

Version

BREW 2.0 BREW 2.1 BREW 3.1 BREW 4.0
X X X O

Reference

BREW API pim_IRecordStore

Member

Public Functions
SFCError AddRecord( UInt08ConstPtr entry , SInt32 length , RecordIDPtr id )
Add a record to the record store and returns a unique identifier for the record.
SFCError AddRecord( SFXBufferConstRef entry , RecordIDPtr id )
Add a record to the record store and returns a unique identifier for the record.
SFCError GetChangesSince( SInt64Ptr currSeqNum , SInt64 seqNum , RecordIDPtr addedIDs , SInt32 addedIDLen , SInt32Ptr addedIDLenReq , RecordIDPtr updatedIDs , SInt32 updatedIDLen , SInt32Ptr updatedIDLenreq , RecordIDPtr deletedIDs , SInt32 deletedIDLen , SInt32Ptr deletedIDLenreq , RecordIDPtr unchangedIDs , SInt32 unchangedIDLen , SInt32Ptr unchangedIDLenreq )
Return a list of record identifiers for all the records that changed since the provided sequence number.
SFCError GetRecord( RecordID id , SInt32 offset , UInt08Ptr entry , SInt32 length , SInt32Ptr lenreq )
Retrieve the record with the given ID from the given device. Note that a record id is only unique per device.
SFCError GetRecord( RecordID id , SInt32 offset , SFXBufferPtr entry )
Retrieve the record with the given ID from the given device. Note that a record id is only unique per device.
static
SFBPimRecordStoreSmp
NewInstance( SFCErrorPtr exception = null )
Create a new SFBPimRecordStore instance.
static
SFBPimRecordStoreSmp
NewInstance( AEECLSID id , SFCErrorPtr exception = null )
Create a new SFBPimRecordStore instance.
SFCError OnChange( SFBSignalSmpConstRef signal , ActionType action , SFBQuerySmpPtr reg )
Allows the client to specify a signal object that will be set when the specified action takes place on the underlying record store.
SFCError RemoveRecord( RecordID id )
Remove the record with the given record id from the given device.
SFCError Search( UInt08ConstPtr criteria , SInt32 length , RecordIDPtr ids , SInt32 idLen , SInt32Ptr idLenreq )
Return a list of unique record identifiers for all the records that match the specified criteria.
SFCError Search( SFXBufferConstRef criteria , RecordIDPtr ids , SInt32 idLen , SInt32Ptr idLenreq )
Return a list of unique record identifiers for all the records that match the specified criteria.
SFCError UpdateRecord( RecordID id , UInt08ConstPtr entry , SInt32 length )
Update an existing record.
SFCError UpdateRecord( RecordID id , SFXBufferConstRef entry )
Update an existing record.
SFCError QueryInterface( AEECLSID clsid , VoidHandle handle ) (inherits from SFBQuery)
Ask an object for another API contract from the object in question.
SFCError QueryInterface( AEECLSID clsid , SFBBaseSmpPtr handle ) (inherits from SFBQuery)
Ask an object for another API contract from the object in question.
SFBBaseSmp QueryInterface( AEECLSID clsid ) (inherits from SFBQuery)
Ask an object for another API contract from the object in question.
Void Self( AEECLSID clsidReq , SFBQuerySmpPtr clone , AEECLSID clsidImp ) (inherits from SFBQuery)
Helper macro for those implementing an object with a single interface.
SFBQuerySmp Self( AEECLSID clsidReq , AEECLSID clsidImp ) (inherits from SFBQuery)
Helper macro for those implementing an object with a single interface.
Protected Functions
static
SFBBaseSmp
FactoryByCreate( AEECLSID id , SFCErrorPtr exception = null ) (inherits from SFBBase)
Create the instance for the specified ClassID's interface.
static
SFBBaseSmp
FactoryByQuery( SFBQuerySmpConstRef query , AEECLSID id , SFCErrorPtr exception = null ) (inherits from SFBBase)
Create the instance for the specified ClassID's interface using the SFBQuery instance.
Types
ActionType
Aliased Type.
AliasEnum
Aliased Constants.
Record
Aliased Type.
RecordID
Aliased Type.
RecordIDs
Aliased Type.
SearchCriteria
Aliased Type.

SFBPimRecordStore::AddRecord
Add a record to the record store and returns a unique identifier for the record.
[ public ]
SFCError AddRecord(
    UInt08ConstPtr entry   // the record to be added to the record store specified as a sequence of octets (8-bit bytes)
    SInt32 length          // the number of the elements in Entry
    RecordIDPtr id         // on success, the unique record identifier for the record that was added to the record store
);
[ public ]
SFCError AddRecord(
    SFXBufferConstRef entry   // the record to be added to the record store specified as a sequence of octets (8-bit bytes)
    RecordIDPtr id            // on success, the unique record identifier for the record that was added to the record store
);

Reference

BREW API pim_IRecordStore_AddRecord | SFBPimRecordStore::RecordID


SFBPimRecordStore::GetChangesSince
Return a list of record identifiers for all the records that changed since the provided sequence number.
[ public ]
SFCError GetChangesSince(
    SInt64Ptr currSeqNum          // on success, the current sequence number
    SInt64 seqNum                 // the sequence number to be used as a reference for returning changed records
    RecordIDPtr addedIDs          // on success, a list of record IDs that were added since the given seqNum
    SInt32 addedIDLen             // the number of the elements in addedIDs
    SInt32Ptr addedIDLenReq       // on success, the number of the elements that make up addedIDs
    RecordIDPtr updatedIDs        // on success, a list of record IDs that were updated since the given seqNum
    SInt32 updatedIDLen           // the number of the elements in updatedIDs
    SInt32Ptr updatedIDLenreq     // on success, the number of the elements that make up updatedIDs
    RecordIDPtr deletedIDs        // on success, a list of record IDs that were deleted since the given seqNum.
    SInt32 deletedIDLen           // the number of the elements in deletedIDs
    SInt32Ptr deletedIDLenreq     // on success, the number of the elements that make up deletedIDs
    RecordIDPtr unchangedIDs      // on success, a list of record IDs that were unchanged since the given seqNum.
    SInt32 unchangedIDLen         // the number of the elements in unchangedIDs
    SInt32Ptr unchangedIDLenreq   // on success, the number of the elements that make up unchangedIDs
);

Reference

BREW API pim_IRecordStore_GetChangesSince | SFBPimRecordStore::RecordID


SFBPimRecordStore::GetRecord
Retrieve the record with the given ID from the given device. Note that a record id is only unique per device.
[ public ]
SFCError GetRecord(
    RecordID id        // the unique record identifier for the record that is to be updated
    SInt32 offset      // starting offset in record sequence
    UInt08Ptr entry    // the record obtained from the record store
    SInt32 length      // the number of the elements in entry
    SInt32Ptr lenreq   // on success, the number of the elements that make up entry
);
[ public ]
SFCError GetRecord(
    RecordID id          // the unique record identifier for the record that is to be updated
    SInt32 offset        // starting offset in record sequence
    SFXBufferPtr entry   // the record obtained from the record store
);

Reference

BREW API pim_IRecordStore_GetRecord | SFBPimRecordStore::RecordID


SFBPimRecordStore::NewInstance
Create a new SFBPimRecordStore instance.
[ public, static ]
SFBPimRecordStoreSmp NewInstance(
    SFCErrorPtr exception = null   // Error
);
[ public, static ]
SFBPimRecordStoreSmp NewInstance(
    AEECLSID id                    // Class ID
    SFCErrorPtr exception = null   // Error
);

SFBPimRecordStore::OnChange
Allows the client to specify a signal object that will be set when the specified action takes place on the underlying record store.
[ public ]
SFCError OnChange(
    SFBSignalSmpConstRef signal   // an SFBSignal object that will be set when change occurs in the record store
    ActionType action             // what type of change to monitor
    SFBQuerySmpPtr reg            // on successful completion, a registration object the caller must hold onto for as long as it wishes to be notified of changes
);

Reference

BREW API pim_IRecordStore_OnChange | SFBPimRecordStore::ActionType


SFBPimRecordStore::RemoveRecord
Remove the record with the given record id from the given device.
[ public ]
SFCError RemoveRecord(
    RecordID id   // the unique record identifier for the record that is to be removed
);

Reference

BREW API pim_IRecordStore_RemoveRecord | SFBPimRecordStore::RecordID


SFBPimRecordStore::Search
Return a list of unique record identifiers for all the records that match the specified criteria.
[ public ]
SFCError Search(
    UInt08ConstPtr criteria   // the search criterion in the format specified by the class implementation
    SInt32 length             // the number of the elements in criteria
    RecordIDPtr ids           // on success, a list of record IDs that match the given criteria
    SInt32 idLen              // the number of the elements in ids
    SInt32Ptr idLenreq        // on success, the number of the elements that make up ids
);
[ public ]
SFCError Search(
    SFXBufferConstRef criteria   // the search criterion in the format specified by the class implementation
    RecordIDPtr ids              // on success, a list of record IDs that match the given criteria
    SInt32 idLen                 // the number of the elements in ids
    SInt32Ptr idLenreq           // on success, the number of the elements that make up ids
);

Reference

BREW API pim_IRecordStore_Search | SFBPimRecordStore::RecordID


SFBPimRecordStore::UpdateRecord
Update an existing record.
[ public ]
SFCError UpdateRecord(
    RecordID id            // the unique record identifier for the record that is to be updated
    UInt08ConstPtr entry   // the record data to replace the existing record in the record store specified as a sequence of octets (8-bit bytes).
    SInt32 length          // the number of the elements in entry
);
[ public ]
SFCError UpdateRecord(
    RecordID id               // the unique record identifier for the record that is to be updated
    SFXBufferConstRef entry   // the record data to replace the existing record in the record store specified as a sequence of octets (8-bit bytes).
);

Reference

BREW API pim_IRecordStore_UpdateRecord | SFBPimRecordStore::RecordID


SFBPimRecordStore::ActionType
Aliased Type.
SFMTYPEDEFALIAS(pim_IRecordStoreUtil_ActionType, ActionType)

Reference

BREW API pim_IRecordStoreUtil_ActionType


SFBPimRecordStore::AliasEnum
Aliased Constants.
enum AliasEnum {
    EBASE               = pim_IRecordStore_EBASE,
    EINVALIDRECID       = pim_IRecordStore_EINVALIDRECID,
    EINVALIDSEQNUM      = pim_IRecordStore_EINVALIDSEQNUM,
    ESTALESEQNUM        = pim_IRecordStore_ESTALESEQNUM,
    Action_Add          = pim_IRecordStore_Action_Add,
    Action_Delete       = pim_IRecordStore_Action_Delete,
    Action_Update       = pim_IRecordStore_Action_Update,
    Action_Commit       = pim_IRecordStore_Action_Commit,
    Action_Writeable    = pim_IRecordStore_Action_Writeable,
    Action_Readable     = pim_IRecordStore_Action_Readable
};
SFMTYPEDEFTYPE(AliasEnum)

SFBPimRecordStore::Record
Aliased Type.
SFMTYPEDEFALIAS(pim_IRecordStoreUtil_Record, Record)

Reference

BREW API pim_IRecordStoreUtil_Record


SFBPimRecordStore::RecordID
Aliased Type.
SFMTYPEDEFALIAS(pim_IRecordStoreUtil_RecordID, RecordID)

Reference

BREW API pim_IRecordStoreUtil_RecordID


SFBPimRecordStore::RecordIDs
Aliased Type.
SFMTYPEDEFALIAS(pim_IRecordStoreUtil_RecordIDs, RecordIDs)

Reference

BREW API pim_IRecordStoreUtil_RecordIDs


SFBPimRecordStore::SearchCriteria
Aliased Type.
SFMTYPEDEFALIAS(pim_IRecordStoreUtil_SearchCriteria, SearchCriteria)

Reference

BREW API pim_IRecordStoreUtil_SearchCriteria