Difference between revisions of "Truxton file get media id"
Jump to navigation
Jump to search
| (6 intermediate revisions by the same user not shown) | |||
| Line 1: | Line 1: | ||
This retrieves the [https://en.wikipedia.org/wiki/Universally_unique_identifier GUID] of the media this file belongs to. | This retrieves the [https://en.wikipedia.org/wiki/Universally_unique_identifier GUID] of the media this file belongs to. | ||
| − | It corresponds to the <code>MediaID</code> column of the <code>File</code> table. | + | It corresponds to the <code>[MediaID]</code> column of the <code><nowiki>[</nowiki>[[File Table|File]]<nowiki>]</nowiki></code> table. |
=Syntax= | =Syntax= | ||
| − | < | + | <source lang="C"> |
| − | void truxton_file_get_media_id( uint64_t file_handle, char * destination_string, size_t max_size ) | + | void truxton_file_get_media_id( uint64_t file_handle, char * destination_string, size_t max_size ); |
| − | </ | + | </source> |
=Parameters= | =Parameters= | ||
==<code>file_handle</code>== | ==<code>file_handle</code>== | ||
| − | The handle created by the [[truxton_file_open_id]] | + | The handle created by the [[truxton_file_open_id]] or [[truxton_file_open_md5]] call. |
==<code>destination_string</code>== | ==<code>destination_string</code>== | ||
| Line 18: | Line 18: | ||
=Sample= | =Sample= | ||
| − | + | <source lang="C" highlight="12"> | |
| − | < | + | void 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 | + | return; |
} | } | ||
char guid_string[ 40 ]; | char guid_string[ 40 ]; | ||
| − | + | truxton_file_get_media_id( file, guid_string, sizeof(guid_string) ); | |
| + | truxton_file_free( file ); | ||
| − | printf( " | + | printf( "Media ID is %s\n", guid_string ); |
} | } | ||
| − | </ | + | </source> |
Latest revision as of 04:42, 13 February 2021
This retrieves the GUID of the media this file belongs to.
It corresponds to the [MediaID] column of the [File] table.
Syntax
void truxton_file_get_media_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_media_id( file, guid_string, sizeof(guid_string) );
truxton_file_free( file );
printf( "Media ID is %s\n", guid_string );
}
