Difference between revisions of "Truxton file get media id"
Jump to navigation
Jump to search
(Created page with "This tells you the offset into the opened file where the next read will take place. =Syntax= <syntaxhighlight lang="C"> void truxton_file_get_id( uint64_t file_handle, char *...") |
|||
| (7 intermediate revisions by the same user not shown) | |||
| Line 1: | Line 1: | ||
| − | This | + | 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><nowiki>[</nowiki>[[File Table|File]]<nowiki>]</nowiki></code> table. | ||
=Syntax= | =Syntax= | ||
| − | < | + | <source lang="C"> |
| − | void | + | 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 17: | 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 );
}
