Difference between revisions of "Truxton investigation remove media"
Jump to navigation
Jump to search
| (2 intermediate revisions by the same user not shown) | |||
| Line 1: | Line 1: | ||
Removes a piece of media from an investigation. | Removes a piece of media from an investigation. | ||
| − | This will | + | This will delete a record in the <code>[InvestigationMedia]</code>. |
=Syntax= | =Syntax= | ||
| Line 14: | Line 14: | ||
==<code>media_id</code>== | ==<code>media_id</code>== | ||
The string representation of a [https://en.wikipedia.org/wiki/Universally_unique_identifier GUID.] | The string representation of a [https://en.wikipedia.org/wiki/Universally_unique_identifier GUID.] | ||
| − | This value should be present in the <code>[ID]</code> column of the <code>[Media]</code> table. | + | This value should be present in the <code>[ID]</code> column of the <code><nowiki>[</nowiki>[[Media Table|Media]]<nowiki>]</nowiki></code> table. |
=Return value= | =Return value= | ||
| Line 24: | Line 24: | ||
=Sample= | =Sample= | ||
| − | <source lang="C" highlight=" | + | <source lang="C" highlight="5"> |
void drop_media( uint64_t truxton, char const * investigation_guid, char const * media_guid ) | void drop_media( uint64_t truxton, char const * investigation_guid, char const * media_guid ) | ||
{ | { | ||
| − | uint64_t investigation = | + | uint64_t investigation = truxton_investigation_open_id( truxton, investigation_guid ); |
| − | |||
| − | |||
if ( truxton_investigation_remove_media( investigation, media_guid ) != 0 ) | if ( truxton_investigation_remove_media( investigation, media_guid ) != 0 ) | ||
Latest revision as of 07:48, 3 February 2024
Removes a piece of media from an investigation.
This will delete a record in the [InvestigationMedia].
Contents
Syntax
int truxton_investigation_remove_media( uint64_t investigation_handle, char const * media_id );
Parameters
investigation_handle
The handle to the investigation object.
This handle comes from calling truxton_investigation_create().
media_id
The string representation of a GUID.
This value should be present in the [ID] column of the [Media] table.
Return value
A non-zero value on success, zero on failure.
Remarks
This does not delete the media from Truxton. It merely disassociates it from the investigation.
Sample
void drop_media( uint64_t truxton, char const * investigation_guid, char const * media_guid )
{
uint64_t investigation = truxton_investigation_open_id( truxton, investigation_guid );
if ( truxton_investigation_remove_media( investigation, media_guid ) != 0 )
{
printf("Removed Media %s from investigation %s.\n", media_guid, investigation_guid );
}
truxton_investigation_destroy( investigation );
}
