| GEOS SDK TechDocs| | DataStoreNewRecord() ... | DBAlloc() ...

---

DataStoreSetField()

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

DataStoreSetNextRecordID()

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().

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().

DataStoreSetTimeStamp()

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

DataStoreSetVersion()

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

DataStoreStringSearch()

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:

dsToken

Session token to the opened datastore.

paramsPtr

Pointer to a 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().

DataStoreUnlockRecord()

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().