Difference between revisions of "Truxton file get depot id"

From truxwiki.com
Jump to navigation Jump to search
Line 1: Line 1:
This retrieves the [https://en.wikipedia.org/wiki/Universally_unique_identifier GUID] of the [[Depot | depot]] where this file's contents are written.
+
This retrieves the [https://en.wikipedia.org/wiki/Universally_unique_identifier GUID] of the [[Depot|depot]] where this file's contents are written.
 
It corresponds to the <code>[DepotID]</code> column of the <code>[Content]</code> table.
 
It corresponds to the <code>[DepotID]</code> column of the <code>[Content]</code> table.
 +
It should contain a value from the <code>[ID]</code> column of the <code>[Depot]</code> table.
  
 
=Syntax=
 
=Syntax=
<syntaxhighlight lang="C">
+
<source lang="C">
 
void truxton_file_get_depot_id( uint64_t file_handle, char * destination_string, size_t max_size );
 
void truxton_file_get_depot_id( uint64_t file_handle, char * destination_string, size_t max_size );
</syntaxhighlight>
+
</source>
  
 
=Parameters=
 
=Parameters=

Revision as of 21:37, 17 November 2020

This retrieves the GUID of the depot where this file's contents are written. It corresponds to the [DepotID] column of the [Content] table. It should contain a value from the [ID] column of the [Depot] table.

Syntax

void truxton_file_get_depot_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_depot_id( file, guid_string, sizeof(guid_string));
   truxton_file_free(file);

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