Difference between revisions of "Truxton media set id"

From truxwiki.com
Jump to navigation Jump to search
Line 4: Line 4:
  
 
=Syntax=
 
=Syntax=
<syntaxhighlight lang="C">
+
<source lang="C">
 
void truxton_media_set_id( uint64_t media_handle, char * id );
 
void truxton_media_set_id( uint64_t media_handle, char * id );
</syntaxhighlight>
+
</source>
  
 
=Parameters=
 
=Parameters=
Line 20: Line 20:
  
 
=Sample=
 
=Sample=
<syntaxhighlight lang="C" highlight="5">
+
<source lang="C" highlight="5">
void add_folder(uint64_t truxton, char * folder)
+
void add_folder( uint64_t truxton, char * folder )
 
{
 
{
   uint64_t media = truxton_media_create(truxton);
+
   uint64_t media = truxton_media_create( truxton );
  
 
   truxton_media_set_id( media, "1506fd04-3b7f-a872-ba0d-ec43efbdcf9e" );
 
   truxton_media_set_id( media, "1506fd04-3b7f-a872-ba0d-ec43efbdcf9e" );
Line 29: Line 29:
 
   load_all_files( media, folder );
 
   load_all_files( media, folder );
  
   truxton_media_free(media);
+
   truxton_media_free( media );
 
}
 
}
</syntaxhighlight>
+
</source>

Revision as of 23:39, 9 February 2021

Sets the identifier of the media object. This corresponds to the [ID] column of the [Media] table. The media identifier is not random.

Syntax

void truxton_media_set_id( uint64_t media_handle, char * id );

Parameters

media_handle

The handle created by the truxton_media_create or truxton_media_open_id call.

id

The string representation of a GUID.

Remarks

This identifier will be stored in the [ID] column of the [Media] table in the database.

Sample

void add_folder( uint64_t truxton, char * folder )
{
   uint64_t media = truxton_media_create( truxton );

   truxton_media_set_id( media, "1506fd04-3b7f-a872-ba0d-ec43efbdcf9e" );

   load_all_files( media, folder );

   truxton_media_free( media );
}