Transact C client library

sp_insert

Append bytes to the end of a data file.

ANSI Prototype

Possible errors

• ERR_BUSY;
• ERR_INVALID_PARMS;
• ERR_UNKNOWN_OBJECT;
• ERR_NOT_ENOUGH_MEMORY;
• ERR_INVALID_PARAMS;
• ERR_CONFLICT_WITH_ANOTHER;
• Client Library: Unknown session;
• Client Library: Uninitialized client library.

Sample code

{
mfpos_t zbegin;
TYPSID gsid;
TYPOID idint;
const char pdata[4] = { 'e', 'f', 'g', 'h' };
const char *idext= "<Obey$Dir>.Datafile";
_kernel_oserror *e;
/* gsid must be given a value before calling sp_insert */
e= sp_insert(gsid, idext, &idint, (const void *) pdata, (mfpos_t) sizeof(pdata));
if(e)	wimp_report_error(e, 0,0,0,0);
/* For subsequent calls refering to the same data file,
   the app. can now use the idint parameter instead of
   the idext parameter.
   Eg. e= sp_insert(gsid, NULL, &idint, ...); */
}