Truxton message get media id

From truxwiki.com
Jump to navigation Jump to search

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 );
}