Difference between revisions of "Truxton message get media id"
Jump to navigation
Jump to search
| (2 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 message is about. | This retrieves the [https://en.wikipedia.org/wiki/Universally_unique_identifier GUID] of the media this message is about. | ||
| − | This corresponds to the <code>MediaID</code> column of the <code>[[File Table | File]]</code> table. | + | This 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_message_get_media_id( uint64_t message_handle, char * destination_string, size_t max_size ); | void truxton_message_get_media_id( uint64_t message_handle, char * destination_string, size_t max_size ); | ||
| − | </ | + | </source> |
=Parameters= | =Parameters= | ||
| Line 18: | Line 18: | ||
=Sample= | =Sample= | ||
| − | + | <source lang="C" highlight="5"> | |
| − | < | + | void print_id( uint64_t message_handle ) |
| − | |||
{ | { | ||
char guid_string[ 40 ]; | char guid_string[ 40 ]; | ||
| − | truxton_message_get_media_id( message_handle, guid_string, sizeof(guid_string)); | + | truxton_message_get_media_id( message_handle, guid_string, sizeof(guid_string) ); |
| − | printf( "Media ID is %s\n", guid_string); | + | printf( "Media ID is %s\n", guid_string ); |
} | } | ||
| − | </ | + | </source> |
Latest revision as of 12:32, 9 February 2021
This retrieves the GUID of the media this message is about.
This corresponds to the [MediaID] column of the [File] table.
Syntax
void truxton_message_get_media_id( uint64_t message_handle, char * destination_string, size_t max_size );
Parameters
message_handle
The handle to a message created by the truxton_message_create 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 message_handle )
{
char guid_string[ 40 ];
truxton_message_get_media_id( message_handle, guid_string, sizeof(guid_string) );
printf( "Media ID is %s\n", guid_string );
}
