Difference between revisions of "Truxton etl set expander version"

From truxwiki.com
Jump to navigation Jump to search
(Created page with "The optional version number of your ETL process. It will be written to the <code>Version</code> column of the <code> ExpandedFile</code> table. =Synta...")
 
Line 4: Line 4:
 
=Syntax=
 
=Syntax=
 
<syntaxhighlight lang="C">
 
<syntaxhighlight lang="C">
void etl_set_expander_version( uint64_t handle, uint64_t application_version )
+
void etl_set_expander_version( uint64_t handle, uint64_t application_version );
 
</syntaxhighlight>
 
</syntaxhighlight>
  
Line 20: Line 20:
  
 
=Sample=
 
=Sample=
 
 
<syntaxhighlight lang="C" highlight="16">
 
<syntaxhighlight lang="C" highlight="16">
 
#include <TruxtonCAPI.h>
 
#include <TruxtonCAPI.h>

Revision as of 06:50, 10 June 2020

The optional version number of your ETL process. It will be written to the Version column of the ExpandedFile table.

Syntax

void etl_set_expander_version( uint64_t handle, uint64_t application_version );

Parameters

etl_handle

The handle created by the truxton_etl_create call.

application_version

A value to represent the current version of your ETL process. Setting the version number to zero will cause Truxton to use the version information for your executable.

Remarks

If you do not set the version number, Truxton will use a packed version number based on the information in the version resource of your executable.

Sample

#include <TruxtonCAPI.h>

void main( void )
{
    char file_id[ 65 ];

    int exit_loop = 0;

    uint64_t message = 0;
    uint64_t app = truxton_etl_create();

    truxton_etl_set_application_name( app, "Sample C ETL" );
    truxton_etl_set_stage_number( app, 42 );
    truxton_etl_set_queue_name( app, "SampleC" );
    truxton_etl_set_expander_identifier( app, 0x05FC0BF6A57726A0 );
    truxton_etl_set_expander_version( app, 0 );

    while( exit_loop == 0 )
    {
        message = truxton_etl_get_message( app );

        if ( message != 0 )
        {
            // Do something with the message

            memset( file_id, 0x00, sizeof( file_id ) );
            truxton_message_get_file_id( message, file_id, sizeof( file_id ) );

            printf( "Received file id %s\n", file_id );

            truxton_message_destroy( message );
        }
        else
        {
            exit_loop = 1;
        }
    }

    truxton_etl_destroy( app );
}