DataStoreDataError DataStoreSetField( word dsToken, /* session token to opened datastore */ TCHAR *fieldNamePtr, FieldID fieldID, void *dataPtr, word dataSize);
Writes
dataSize
bytes of data (dataPtr) to the passed field. Passing "0" in
dataSize
deletes the field from the record. Returns a
DataStoreDataError
value (DSDE_NO_ERROR if successful).
If referencing field by name, pass "0" in
fieldID
; if referencing field by
FieldID
, pass NULL in
fieldNamePtr
.
Include: datastor.hblockHan
DataStoreError DataStoreSetNextRecordID( word dsToken, /* session token to opened datastore */ RecordID nextID);
Sets the next
RecordID
to be assigned to nextID. Returns a
DataStoreError
value (DSE_NO_ERROR if successful).
Include: datastor.h
See Also: DataStoreSetRecordID()
.
DataStoreDataError DataStoreSetRecordID( word dsToken, /* session token to opened datastore */ RecordID recordID);
Sets the
RecordID
of the current record to recordID; datastore must be opened for exclusive access. If the passed
RecordID
is greater than the next
RecordID
to be assigned, updates the latter with the passed
RecordID
+ 1. Returns a
DataStoreDataError
value (DSDE_NO_ERROR if successful).
Warnings: Overwrites any existing record with the same
RecordID
as the passed value.
Include: datastor.h
See Also: DataStoreSetNextRecordID()
.
DataStoreError DataStoreSetTimeStamp( word dsToken, /* session token to opened datastore */ FileDateAndTime timestamp);
Sets date and time that datastore was last modified to timestamp.
Returns a
DataStoreError
value (DSE_NO_ERROR if successful).
Include: datastor.h
DataStoreError DataStoreSetVersion( word dsToken, /* session token to opened datastore */ ProtocolNumber version);
Sets the datastore's protocol number; this is useful for keeping track of different versions of a datastore. Returns a
DataStoreError
value (DSE_NO_ERROR if successful).
Include: datastor.h
DataStoreError DataStoreStringSearch( word dsToken, /* session token to opened datastore */ SearchParams *paramsPtr);
Performs a string search on the datastore. If it finds a match, updates SP
_startRecord
with the
RecordNum
of the matching record and returns DSE_NO_ERROR. If it reaches the first or last record without finding a match, returns DSE_NO_MORE_RECORDS. Takes the following arguments:
SearchParams
structure.typedef struct { SearchType SP_searchType; RecordNum SP_startRecord; dword SP_maxRecords; FieldID SP_startField; FieldCategory SP_category; TCHAR *SP_searchString; SearchFlags SP_flags; } SearchParams;
Warnings: Returns DSSE_INDEX_RECORD_NUMBER_LIMIT_EXCEEDED if you call this routine on a datastore with more than 4,000 records.
Include: datastor.h
See Also: DataStoreRecordEnum()
,DataStoreFieldEnum()
.
void DataStoreUnlockRecord( word dsToken); /* session token to opened datastore */
Unlocks the current record. If you lock a record with
DataStoreLock()
, you must unlock it with this routine.
Include: datastor.h
See Also: DataStoreLockRecord()
.