Truxton media get evidence bag

This retrieves the identifier of the evidence bag holding the media. It corresponds to the EvidenceBag column of the Media table.

This is an arbitrary string value that Truxton will associate with the media.

Syntax

void truxton_media_get_evidence_bag( 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_evidence_id( uint64_t truxton )
{
   uint64_t media = truxton_media_open_id( truxton, "150929ce-bf30-4d5d-08d9-b48a0806c843" );

   if ( media != 0 )
   {
      return;
   }

   char id[ MAX_PATH ];

   truxton_media_get_evidence_bag( media, id, sizeof(id) );

   printf( "Evidence Control ID: %s\n", id );

   truxton_media_free( media );
}