RegisterField

The function register_field adds RMS table field name to the internal data retrieving field name list.  When you search the RMS file, only those fields specified in the field name list have their data stored in the data buffer.

void register_field(

int rmsHandle,          // open RMS file handle

har *fldname                    // field name

)

Parameters

rmsHandle

Open RMS file handle

fldname

The RMS table field name

Return Values

No return values

Remarks

Use register_field to add field names to internal data retrieving field name list so that only those fields in the field name list have their data stored in the internal data buffer.  To get field data, call first_registered_fieldfirst_registered_field and nextregisteredfieldnext_registered_field to get each field name in field name list and pass it to the data retrieving functions.  To clear the field name list, call unregister_fieldunregister_fields.  If the field name list is empty, by default, all fields data are stored in the internal data buffer.

See Also

unregister_fieldunregister_fields, get_string_fieldget_string_field, get_char_fieldget_char_field, get_integer_fieldget_integer_field, get_long_fieldget_long_field, get_real_fieldget_real_field, get_money_fieldget_money_field,  get_date_fieldget_date_field, get_time_fieldget_time_field.