Difference between revisions of "Truxton media set id"

From truxwiki.com
Jump to navigation Jump to search
 
(One intermediate revision by the same user not shown)
Line 1: Line 1:
 
Sets the identifier of the media object.
 
Sets the identifier of the media object.
This corresponds to the <code>[ID]</code> column of the <code>[Media]</code> table.
+
This corresponds to the <code>[ID]</code> column of the <code><nowiki>[</nowiki>[[Media Table|Media]]<nowiki>]</nowiki></code> table.
 
The [[TGUID#Media_ID|media identifier]] is not random.
 
The [[TGUID#Media_ID|media identifier]] is not random.
  
 
=Syntax=
 
=Syntax=
 
<source 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 const * id );
 
</source>
 
</source>
  
Line 16: Line 16:
  
 
=Remarks=
 
=Remarks=
 
 
This identifier will be stored in the <code>[ID]</code> column of the <code>[Media]</code> table in the database.
 
This identifier will be stored in the <code>[ID]</code> column of the <code>[Media]</code> table in the database.
  

Latest revision as of 07:38, 3 February 2024

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 const * 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 );
}