SophiaFramework UNIVERSE 5.3 |
#include <SFBPimRecordStore.h.hpp>
class SFBPimRecordStore : public SFBQuery;
SFMTYPEDEFWRAPPER(SFBPimRecordStore)
BREW 2.0 | BREW 2.1 | BREW 3.1 | BREW 4.0 |
---|---|---|---|
X | X | X | O |
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.
|
[ 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 );
[ 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 );
[ 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 );
[ public, static ] SFBPimRecordStoreSmp NewInstance( SFCErrorPtr exception = null // Error );
[ public, static ] SFBPimRecordStoreSmp NewInstance( AEECLSID id // Class ID SFCErrorPtr exception = null // Error );
[ 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 );
[ public ] SFCError RemoveRecord( RecordID id // the unique record identifier for the record that is to be removed );
[ 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 );
[ 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). );
SFMTYPEDEFALIAS(pim_IRecordStoreUtil_ActionType, ActionType)
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)
SFMTYPEDEFALIAS(pim_IRecordStoreUtil_Record, Record)
SFMTYPEDEFALIAS(pim_IRecordStoreUtil_RecordID, RecordID)
SFMTYPEDEFALIAS(pim_IRecordStoreUtil_RecordIDs, RecordIDs)
SFMTYPEDEFALIAS(pim_IRecordStoreUtil_SearchCriteria, SearchCriteria)
Copyright(c) 2002 - 2024 Sophia Cradle Incorporated All Rights Reserved. |