Difference between revisions of "Truxton file get media id"

From truxwiki.com
Jump to navigation Jump to search
(Created page with "This tells you the offset into the opened file where the next read will take place. =Syntax= <syntaxhighlight lang="C"> void truxton_file_get_id( uint64_t file_handle, char *...")
 
Line 1: Line 1:
This tells you the offset into the opened file where the next read will take place.
+
This retrieves the [https://en.wikipedia.org/wiki/Universally_unique_identifier GUID] of the media this file belongs to.
 +
It corresponds to the <code>MediaID</code> column of the <code>File</code> table.
  
 
=Syntax=
 
=Syntax=
 
<syntaxhighlight lang="C">
 
<syntaxhighlight lang="C">
void truxton_file_get_id( uint64_t file_handle, char * destination_string, size_t max_size )
+
void truxton_file_get_media_id( uint64_t file_handle, char * destination_string, size_t max_size )
 
</syntaxhighlight>
 
</syntaxhighlight>
  

Revision as of 06:59, 6 June 2020

This retrieves the GUID of the media this file belongs to. It corresponds to the MediaID column of the File table.

Syntax

void truxton_file_get_media_id( uint64_t file_handle, char * destination_string, size_t max_size )

Parameters

file_handle

The handle created by the truxton_file_open_id of truxton_file_open_md5 call.

destination_string

The string to be written to.

max_size

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

Sample

int print_id(uint64_t truxton)
{
   uint64_t file = truxton_file_open_md5(truxton, "9ec8fb6095c35eff2b236863b7caaf10");

   if ( file != 0 )
   {
      return(0);
   }

   char guid_string[ 40 ];

   truxton_file_get_id( file, guid_string, sizeof(guid_string));

   printf( "File ID is %s\n", guid_string);
}