Truxton investigation add media - Revision history

Sam: /* media_id */

2024-02-03T11:50:04Z

media_id

Sam: /* Sample */

2021-02-18T17:54:40Z

Sample

Sam: Created page with "Adds a piece of media to an investigation. This will make a record in the `[InvestigationMedia]`. =Syntax= int truxton_investigation_add_media( u..."

2021-02-18T17:52:55Z

Created page with "Adds a piece of media to an investigation. This will make a record in the <code>[InvestigationMedia]</code>. =Syntax= <source lang="C"> int truxton_investigation_add_media( u..."

New page

Adds a piece of media to an investigation.
This will make a record in the <code>[InvestigationMedia]</code>.

=Syntax=
<source lang="C">
int truxton_investigation_add_media( uint64_t investigation_handle, char const * media_id );
</source>

=Parameters=
==<code>investigation_handle</code>==
The handle to the investigation object.
This handle comes from calling <code>[[truxton_investigation_create]]()</code>.

==<code>media_id</code>==
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.

=Return value=
A non-zero value on success, zero on failure.

=Sample=
<source lang="C" highlight="7">
void add_media( uint64_t truxton, char const * investigation_guid, char const * media_guid )
{
uint64_t investigation = truxton_investigation_create( truxton );

truxton_investigation_set_id( investigation, investigation_guid );

if ( truxton_investigation_add_media( investigation, media_guid ) != 0 )
{
printf("Removed Media %s from investigation %s.\n", media_guid, investigation_guid );
}

truxton_investigation_destroy( investigation );
}
</source>

@@ Line 14: / Line 14: @@
 ==<code>media_id</code>==
 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=

@@ Line 29: / Line 29: @@
     if ( truxton_investigation_add_media( investigation, media_guid ) != 0 )
+    {
-       printf("Removed Media %s from investigation %s.\n", media_guid, investigation_guid );
+       printf("Added Media %s to investigation %s.\n", media_guid, investigation_guid );
+    }

Truxton investigation add media - Revision history

Sam: /* media_id */

Sam: /* Sample */

Sam: Created page with "Adds a piece of media to an investigation. This will make a record in the [InvestigationMedia]. =Syntax= int truxton_investigation_add_media( u..."

Sam: Created page with "Adds a piece of media to an investigation. This will make a record in the `[InvestigationMedia]`. =Syntax= int truxton_investigation_add_media( u..."