Programming Guide

Restores saved data to some of the screen

int sm_rs_data(int first_field, int last_field, char *buffer);

first_field, last_field

Specifies the range of data items to restore, where all data between first_field and last_field are restored to the screen.

buffer

The address of a buffer, initialized by sm_sv_data, that stores the data to restore. Data items are stored in buffer as null-terminated character strings. The contents of a scrollable array is preceded by 2 bytes giving the total number of items saved (high order byte first); each item is preceded by two bytes of display attribute, and followed by a null. There is an additional null following all the scrolling data.

C only

• 0 Success.

• -1 Error, usually memory allocation failure.

sm_rs_data restores all data items between first_field and last_field, both off- and onscreen, from a buffer initialized by sm_sv_data.

The range of fields passed to sm_rs_data must match those passed to sm_sv_data and buffer must be a value returned by that function; otherwise, serious errors may occur. For more information on saving data for later retrieval by sm_rs_data, refer to sm_sv_data.

sm_sv_data

---

---