Difference between revisions of "Truxton file get media id"

From truxwiki.com
Jump to navigation Jump to search
Line 9: Line 9:
 
=Parameters=
 
=Parameters=
 
==<code>file_handle</code>==
 
==<code>file_handle</code>==
The handle created by the [[truxton_file_open_id]] of [[truxton_file_open_md5]] call.
+
The handle created by the [[truxton_file_open_id]] or [[truxton_file_open_md5]] call.
  
 
==<code>destination_string</code>==
 
==<code>destination_string</code>==

Revision as of 09:02, 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 or 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_media_id( file, guid_string, sizeof(guid_string));

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