View source for Truxton media set id

Sets the identifier of the media object.
This corresponds to the <code>ID</code> column of the <code>[[File Table | File]]</code> table.

=Syntax=
<syntaxhighlight lang="C">
void truxton_media_set_id( uint64_t media_handle, char * id );
</syntaxhighlight>

=Parameters=
==<code>media_handle</code>==
The handle created by the [[truxton_media_create]] or [[truxton_media_open_id]] call.

==<code>id</code>==
The string representation of a [https://en.wikipedia.org/wiki/Universally_unique_identifier GUID.]

=Remarks=

This identifier will be stored in the <code>ID</code> column of the <code>Media</code> table in the database.

=Sample=
<syntaxhighlight lang="C" highlight="5">
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);
}
</syntaxhighlight>