Sam: /* Sample */

2024-04-14T06:52:30Z

Sample

Sam: Created page with "This commits everything to the database. =Syntax= int truxton_communication_finished( uint64_t communication_handle ); =Parameters= ==`commu..."`


2021-10-04T16:08:31Z
Created page with "This commits everything to the database.  =Syntax= <source lang="C"> int truxton_communication_finished( uint64_t communication_handle ); </source>  =Parameters= ==<code>commu..."
New page
This commits everything to the database.



=Syntax=

<source lang="C">

int truxton_communication_finished( uint64_t communication_handle );

</source>



=Parameters=

==<code>communication_handle</code>==

The handle returned by calling <code>[[truxton_communication_create]]</code>.



=Return value=

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



=Sample=

<source lang="C" highlight="76">

#define TAG_ORIGIN_AUTOMATIC (1)

#define TAG_ORIGIN_HUMAN     (2)



void add_message( uint64_t truxton, uint64_t parent_file )

{

   char id[40];

   char sender_id[80];



   uint64_t communication = truxton_communication_create( parent_file );



   FILETIME now;



   GetSystemTimePreciseAsFileTime( &now );



   ULARGE_INTEGER ticks;



   ticks.LowPart = now.dwLowDateTime;

   ticks.HighPart = now.dwHighDateTime;



   truxton_communication_set_received( communication, ticks.QuadPart );

   truxton_communication_set_sent( communication, ticks.QuadPart );

   truxton_communication_set_type( communication, MESSAGE_TYPE_MIME );

   truxton_communication_set_subject( communication, "Test Message" );



   if ( truxton_communication_save( communication ) == 0 )

   {

      printf( "Failed to add communication to Truxton\n" );

      truxton_communication_destroy( communication );

      return;

   }



   truxton_communication_get_id( parent_file, id, sizeof(id) );

   printf( "Saved as id %s\n", id );



   // Now that we have an id, we can add participants.



   if ( truxton_communication_add_participant( communication, MESSAGE_PARTICIPANT_FROM, "sam@abc.xyz", sender_id, sizeof(sender_id) ) == 0 )

   {

      printf( "Could not save FROM participant.\n" );

   }

   else

   {

      printf( "Sender id is %s\n", sender_id );

   }



   if ( truxton_communication_add_participant( communication, MESSAGE_PARTICIPANT_TO, "laura@abc.xyz", NULL, 0 ) == 0 )

   {

      printf( "Could not save TO participant.\n" );

   }



   uint64_t message_body_1 = create_message_body_1( truxton );

   uint64_t message_body_2 = create_message_body_2( truxton );

   uint64_t attachment_1 = create_attachment_1( truxton );

   uint64_t attachment_2 = create_attachment_2( truxton );



   if ( truxton_communication_add_piece( communication, message_body_1, ORIGIN_EMAIL_BODY, 1 ) == 0 )

   {

      printf( "Could not add first body to message.\n" );

   }



   if ( truxton_communication_add_piece( communication, message_body_1, ORIGIN_EMAIL_BODY, 2 ) == 0 )

   {

      printf( "Could not add second body to message.\n" );

   }



   if ( truxton_communication_add_piece( communication, attachment_1, ORIGIN_EMAIL_ATTACHMENT, 1 ) == 0 )

   {

      printf( "Could not add first attachment to message.\n" );

   }



   if ( truxton_communication_add_piece( communication, attachment_2, ORIGIN_EMAIL_ATTACHMENT, 2 ) == 0 )

   {

      printf( "Could not add second attachment to message.\n" );

   }



   if ( truxton_communication_finished( communication ) == 0 )

   {

      printf( "Could not complete message record.\n" );

   }



   if ( truxton_communication_tag( communication, "Man Made", "Testing the API", TAG_ORIGIN_HUMAN ) == 0 )

   {

      printf( "Could not tag message.\n" );

   }



   truxton_communication_destroy( communication );

}

</source>

Truxton communication finished - Revision history

Sam: /* Sample */

Sam: Created page with "This commits everything to the database. =Syntax= int truxton_communication_finished( uint64_t communication_handle ); =Parameters= ==commu..."

Sam: Created page with "This commits everything to the database. =Syntax= int truxton_communication_finished( uint64_t communication_handle ); =Parameters= ==`commu..."`