Difference between revisions of "Truxton media get root file id"

From truxwiki.com
Jump to navigation Jump to search
(Created page with "This retrieves the [https://en.wikipedia.org/wiki/Universally_unique_identifier GUID] of the topmost file in the media. This corresponds to the <code>ID</code> column of the <...")
 
Line 1: Line 1:
This retrieves the [https://en.wikipedia.org/wiki/Universally_unique_identifier GUID] of the topmost file in the media.
+
This retrieves the [https://en.wikipedia.org/wiki/Universally_unique_identifier GUID] of the latest [[Type_Root|root]] file in the media.
 
This corresponds to the <code>ID</code> column of the <code>[[File Table|File]]</code> table.
 
This corresponds to the <code>ID</code> column of the <code>[[File Table|File]]</code> table.
  
Line 18: Line 18:
  
 
=Sample=
 
=Sample=
 
 
<syntaxhighlight lang="C" highlight="12">
 
<syntaxhighlight lang="C" highlight="12">
 
void print_id(uint64_t truxton)
 
void print_id(uint64_t truxton)

Revision as of 08:24, 26 July 2020

This retrieves the GUID of the latest root file in the media. This corresponds to the ID column of the File table.

Syntax

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

Parameters

media_handle

The handle created by the truxton_media_open_id or truxton_media_create 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_id(uint64_t truxton)
{
   uint64_t media = truxton_media_open_id(truxton, "1506fd04-3b7f-a872-ba0d-ec43efbdcf9e");

   if ( media != 0 )
   {
      return;
   }

   char guid_string[ 40 ];

   truxton_media_get_root_file_id( media, guid_string, sizeof(guid_string));
   truxton_media_free(media);

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