gsk_copy_record()

Copies a database record.

Format

   #include <gskcms.h>

   gsk_status gsk_copy_record ( 
                                gskdb_record *      in_record,
                                gskdb_record **     out_record)

Parameters

in_record: Specifies the source record.
out_record: Returns the copied record. The application should call the gsk_free_record() routine when the record is no longer needed.

Results

The function return value will be 0 if no error is detected. Otherwise, it will be one of the return codes listed in the gskcms.h include file. This is a possible error:

[CMSERR_NO_MEMORY]: Insufficient storage is available.

Usage

The gsk_copy_record() routine will allocate the output record and then copy the input record to the output record. The address of the copied record will then be returned to the application.