classname_updated_bitmap_get_fldname

This function returns the field number and position of any updated field(s).

Prototype

 
    MCO_RET	classname_updated_bitmap_get_fldname(	/*IN*/ classname * handle, 
                                  uint2 * index,  char * dest, 
                                  uint2 dest_size, 
                                  uint2 * len);
 

Arguments

handle The address of a variable of type class handle

index

Address of an unsigned 2 byte integer

dest

Character array to receive the field name

dest_size

The size of the character array to receive the field name – i.e. sizeof(dest)

len

Address of an unsigned short to receive the length of the fieldname

Description

This function searches the passed object for a field declared bool updated_bitmap[] and if found returns the field number and position of the updated field. (Note that if the schema definition of this class has a field declared bool updated_bitmap[] then the runtime will automatically set the corresponding bit in this field when the value of any other field in this database object is changed. It is the developer's responsibility to include field bool updated_bitmap[] in any class for which this functionality is desired.)

Return Codes

MCO_S_OK Updated bitmap field and position found
MCO_S_NOTFOUND Updated bitmap field found but position in field not found