Truxton media get case number

This retrieves the case number of the media. It corresponds to the [CaseNumber] column of the [Media] table.

This is an arbitrary string value that Truxton will associate with the media. The format of the case number is whatever the user wishes.

Syntax

void truxton_media_get_case_number( uint64_t media_handle, char * destination_string, size_t max_size );

Parameters

media_handle

The handle created by the truxton_media_create or truxton_media_open_id call.

destination_string

The string to be written to.

max_size

The maximum number of characters that can be written to destination_string.

Sample

void print_case( uint64_t truxton )
{
   uint64_t media = truxton_media_open_id( truxton, "150929ce-bf30-4d5d-08d9-b48a0806c843" );

   if ( media != 0 )
   {
      return;
   }

   char case_id[ MAX_PATH ];

   truxton_media_get_case_number( media, case_id, sizeof(case_id) );

   printf( "Case: %s\n", case_id);

   truxton_media_free( media );
}