Difference between revisions of "Truxton note set investigation id"

From truxwiki.com
Jump to navigation Jump to search
(Created page with "This frees the resources used by a note object. =Syntax= <source lang="C"> void truxton_note_set_investigation_id( uint64_t note_handle, char cont * id ); </source> =Paramet...")
 
 
(3 intermediate revisions by the same user not shown)
Line 1: Line 1:
This frees the resources used by a note object.
+
This associates the note with a specific investigation.
  
 
=Syntax=
 
=Syntax=
 
<source lang="C">
 
<source lang="C">
void truxton_note_set_investigation_id( uint64_t note_handle, char cont * id );
+
void truxton_note_set_investigation_id( uint64_t note_handle, char const * id );
 
</source>
 
</source>
  
Line 12: Line 12:
 
==<code>id</code>==
 
==<code>id</code>==
 
The string representation of a [https://en.wikipedia.org/wiki/Universally_unique_identifier GUID.]
 
The string representation of a [https://en.wikipedia.org/wiki/Universally_unique_identifier GUID.]
 +
It should contain a value from the <code>[ID]</code> column of the <code>[Investigation]</code> table and will be stored in the <code>[InvestigationID]</code> column of the <code>[InvestigatorNote]</code> table.
  
 
=Sample=
 
=Sample=

Latest revision as of 05:39, 15 April 2024

This associates the note with a specific investigation.

Syntax

void truxton_note_set_investigation_id( uint64_t note_handle, char const * id );

Parameters

note_handle

This handle comes from calling truxton_note_create().

id

The string representation of a GUID. It should contain a value from the [ID] column of the [Investigation] table and will be stored in the [InvestigationID] column of the [InvestigatorNote] table.

Sample

void create_note( void )
{
   uint64_t truxton = truxton_create();

   uint64_t note = truxton_note_create( truxton_handle );

   truxton_note_set_object_id( note, "65feb292-7995-137d-77cb-3ed80000000a" );
   truxton_note_set_investigation_id( note, "01da7796-a010-3685-0000-018902cb3b22" );
   truxton_note_set_text( note, "This is an interesting file." );
   truxton_note_set_object_type( note, OBJECT_TYPE_FILE );

   if ( truxton_note_save( note ) == 0 )
   {
      printf( "Cannot save investigation note to the database.\n" );
   }

   truxton_note_destroy( note );
   truxton_destroy( truxton );
}