Difference between revisions of "Truxton file get parent 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 *...")
 
 
(9 intermediate revisions by the same user not shown)
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 parent file of this file.
 +
It corresponds to the <code>[ParentID]</code> column of the <code><nowiki>[</nowiki>[[File Table|File]]<nowiki>]</nowiki></code> table.
 +
The [[TGUID#File_ID|file identifier]] is not random.
  
 
=Syntax=
 
=Syntax=
<syntaxhighlight lang="C">
+
<source lang="C">
void truxton_file_get_id( uint64_t file_handle, char * destination_string, size_t max_size )
+
void truxton_file_get_parent_id( uint64_t file_handle, char * destination_string, size_t max_size );
</syntaxhighlight>
+
</source>
  
 
=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>==
Line 17: Line 19:
  
 
=Sample=
 
=Sample=
 
+
<source lang="C" highlight="12">
<syntaxhighlight lang="C" highlight="12">
+
void print_id( uint64_t truxton )
int print_id(uint64_t truxton)
 
 
{
 
{
   uint64_t file = truxton_file_open_md5(truxton, "9ec8fb6095c35eff2b236863b7caaf10");
+
   uint64_t file = truxton_file_open_md5( truxton, "9ec8fb6095c35eff2b236863b7caaf10" );
  
 
   if ( file != 0 )
 
   if ( file != 0 )
 
   {
 
   {
       return(0);
+
       return;
 
   }
 
   }
  
 
   char guid_string[ 40 ];
 
   char guid_string[ 40 ];
  
   truxton_file_get_id( file, guid_string, sizeof(guid_string));
+
   truxton_file_get_parent_id( file, guid_string, sizeof(guid_string) );
 +
  truxton_file_free( file );
  
   printf( "File ID is %s\n", guid_string);
+
   printf( "Parent file ID is %s\n", guid_string );
 
}
 
}
</syntaxhighlight>
+
</source>

Latest revision as of 04:45, 13 February 2021

This retrieves the GUID of the parent file of this file. It corresponds to the [ParentID] column of the [File] table. The file identifier is not random.

Syntax

void truxton_file_get_parent_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

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

   if ( file != 0 )
   {
      return;
   }

   char guid_string[ 40 ];

   truxton_file_get_parent_id( file, guid_string, sizeof(guid_string) );
   truxton_file_free( file );

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