Difference between revisions of "Truxton media get evidence bag"
Jump to navigation
Jump to search
(Created page with "This retrieves the identifier of the evidence bag holding the media. It corresponds to the <code>EvidenceBag</code> column of the <code>Media</code> table. This is an arbitra...") |
|||
| (2 intermediate revisions by the same user not shown) | |||
| Line 1: | Line 1: | ||
This retrieves the identifier of the evidence bag holding the media. | This retrieves the identifier of the evidence bag holding the media. | ||
| − | It corresponds to the <code>EvidenceBag</code> column of the <code>Media</code> table. | + | It corresponds to the <code>[EvidenceBag]</code> column of the <code><nowiki>[</nowiki>[[Media Table|Media]]<nowiki>]</nowiki></code> table. |
This is an arbitrary string value that Truxton will associate with the media. | This is an arbitrary string value that Truxton will associate with the media. | ||
=Syntax= | =Syntax= | ||
| − | < | + | <source lang="C"> |
void truxton_media_get_evidence_bag( uint64_t media_handle, char * destination_string, size_t max_size ); | void truxton_media_get_evidence_bag( uint64_t media_handle, char * destination_string, size_t max_size ); | ||
| − | </ | + | </source> |
=Parameters= | =Parameters= | ||
| Line 20: | Line 20: | ||
=Sample= | =Sample= | ||
| − | < | + | <source lang="C" highlight="12"> |
| − | void print_evidence_id(uint64_t truxton) | + | void print_evidence_id( uint64_t truxton ) |
{ | { | ||
| − | uint64_t media = truxton_media_open_id(truxton, "150929ce-bf30-4d5d-08d9-b48a0806c843"); | + | uint64_t media = truxton_media_open_id( truxton, "150929ce-bf30-4d5d-08d9-b48a0806c843" ); |
if ( media != 0 ) | if ( media != 0 ) | ||
| Line 32: | Line 32: | ||
char id[ MAX_PATH ]; | char id[ MAX_PATH ]; | ||
| − | truxton_media_get_evidence_bag(media, id, sizeof(id)); | + | truxton_media_get_evidence_bag( media, id, sizeof(id) ); |
| − | printf( "Evidence Control ID: %s\n", id); | + | printf( "Evidence Control ID: %s\n", id ); |
| − | truxton_media_free(media); | + | truxton_media_free( media ); |
} | } | ||
| − | </ | + | </source> |
Latest revision as of 07:43, 3 February 2024
This retrieves the identifier of the evidence bag holding the media.
It corresponds to the [EvidenceBag] column of the [Media] table.
This is an arbitrary string value that Truxton will associate with the media.
Syntax
void truxton_media_get_evidence_bag( uint64_t media_handle, char * destination_string, size_t max_size );
Parameters
media_handle
The handle created by the truxton_media_create or truxton_media_open_id 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_evidence_id( uint64_t truxton )
{
uint64_t media = truxton_media_open_id( truxton, "150929ce-bf30-4d5d-08d9-b48a0806c843" );
if ( media != 0 )
{
return;
}
char id[ MAX_PATH ];
truxton_media_get_evidence_bag( media, id, sizeof(id) );
printf( "Evidence Control ID: %s\n", id );
truxton_media_free( media );
}
