Truxton file create artifact

This creates an artifact from this file that you can use in the Artifact API. An artifact object is how you add records to the [Entity] table.

Syntax

uint64_t truxton_file_create_artifact( uint64_t file_handle );

Parameters

file_handle

The handle created by the truxton_file_open_id or truxton_file_open_md5 call.

Return value

A handle to an artifact object.

Remarks

The artifact created by this function will already have the following initialized:

• The file id will be set to this file's id.
• The media id will be set to this file's media id.
• The object id will be set this file's id.
• The object type will be set to OBJECT_TYPE_FILE

Sample

void process_file( uint64_t truxton )
{
   uint64_t file = truxton_file_open_md5( truxton, "9ec8fb6095c35eff2b236863b7caaf10" );

   uint64_t artifact = truxton_file_create_artifact( file );

   truxton_artifact_set_type( artifact, ENTITY_TYPE_SERIAL_NUMBER );
   truxton_artifact_set_value( artifact, "1234" );
   truxton_artifact_save( artifact );
   truxton_artifact_destroy( artifact );

   truxton_file_free( file );
}