Difference between revisions of "Truxton file get content status"

From truxwiki.com
Jump to navigation Jump to search
Line 1: Line 1:
 
This retrieves the state of the contents of this file.
 
This retrieves the state of the contents of this file.
 
It corresponds to the <code>[ContentStatusID]</code> column of the <code><nowiki>[</nowiki>[[File Table|File]]<nowiki>]</nowiki></code> table.
 
It corresponds to the <code>[ContentStatusID]</code> column of the <code><nowiki>[</nowiki>[[File Table|File]]<nowiki>]</nowiki></code> table.
 +
It should contain a value from the <code>[ID]</code> column of the <code>[ContentStatus]</code> table.
  
 
=Syntax=
 
=Syntax=
<syntaxhighlight lang="C">
+
<source lang="C">
 
uint32_t truxton_file_get_content_status( uint64_t file_handle );
 
uint32_t truxton_file_get_content_status( uint64_t file_handle );
</syntaxhighlight>
+
</source>
  
 
=Parameters=
 
=Parameters=

Revision as of 21:39, 17 November 2020

This retrieves the state of the contents of this file. It corresponds to the [ContentStatusID] column of the [File] table. It should contain a value from the [ID] column of the [ContentStatus] table.

Syntax

uint32_t truxton_file_get_content_status( uint64_t file_handle );

Parameters

file_handle

The handle created by the truxton_file_open_id or truxton_file_open_md5 call.

Return value

The state of the contents of the file. It will be one of the Content Status values.

Sample

void print_it(uint64_t truxton)
{
   uint64_t file = truxton_file_open_md5(truxton, "9ec8fb6095c35eff2b236863b7caaf10");

   if ( file != 0 )
   {
      return;
   }

   uint32_t status = truxton_file_get_content_status( file );

   if ( status == CONTENT_STATUS_ELIMINATED_BY_HASH)
   {
      printf( "Contents not stored because it came from a well-known source.\n" );
   }

   truxton_file_free( file );
}