Difference between revisions of "Truxton file get 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 *...") |
|||
| (8 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 file. |
| + | This corresponds to the <code>[ID]</code> column of the <code><nowiki>[</nowiki>[[File Table|File]]<nowiki>]</nowiki></code> table. | ||
| + | The [[TGUID#File_ID|file identifier]] is not random. | ||
=Syntax= | =Syntax= | ||
| − | < | + | <source lang="C"> |
| − | void truxton_file_get_id( uint64_t file_handle, char * destination_string, size_t max_size ) | + | void truxton_file_get_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 19: | ||
=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_id( file, guid_string, sizeof(guid_string)); | + | truxton_file_get_id( file, guid_string, sizeof(guid_string) ); |
| + | truxton_file_free( file ); | ||
| − | printf( "File ID is %s\n", guid_string); | + | printf( "File ID is %s\n", guid_string ); |
} | } | ||
| − | </ | + | </source> |
Latest revision as of 04:40, 13 February 2021
This retrieves the GUID of the file.
This corresponds to the [ID] column of the [File] table.
The file identifier is not random.
Syntax
void truxton_file_get_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_id( file, guid_string, sizeof(guid_string) );
truxton_file_free( file );
printf( "File ID is %s\n", guid_string );
}
