Difference between revisions of "Truxton message set parent id"

From truxwiki.com
Jump to navigation Jump to search
Line 3: Line 3:
  
 
=Syntax=
 
=Syntax=
<syntaxhighlight lang="C">
+
<source lang="C">
 
void truxton_message_set_parent_id( uint64_t message_handle, char * id );
 
void truxton_message_set_parent_id( uint64_t message_handle, char * id );
</syntaxhighlight>
+
</source>
  
 
=Parameters=
 
=Parameters=
Line 15: Line 15:
  
 
=Remarks=
 
=Remarks=
 
 
This identifier should be a value from the <code>ID</code> column of the <code>File</code> table in the database.
 
This identifier should be a value from the <code>ID</code> column of the <code>File</code> table in the database.
  
 
=Sample=
 
=Sample=
<syntaxhighlight lang="C" highlight="7">
+
<source lang="C" highlight="7">
void set_parent(uint64_t message, uint64_t file)
+
void set_parent( uint64_t message, uint64_t file )
 
{
 
{
 
   char id[40];
 
   char id[40];
  
   truxton_file_get_parent_id(file, id, sizeof(id));
+
   truxton_file_get_parent_id( file, id, sizeof(id) );
  
 
   truxton_message_set_parent_id( message, id );
 
   truxton_message_set_parent_id( message, id );
 
}
 
}
</syntaxhighlight>
+
</source>

Revision as of 12:32, 9 February 2021

Sets the identifier of the parent of the file in the message. This corresponds to the ParentFileID column of the File table.

Syntax

void truxton_message_set_parent_id( uint64_t message_handle, char * id );

Parameters

message_handle

The handle created by the truxton_message_create call.

id

The string representation of a GUID.

Remarks

This identifier should be a value from the ID column of the File table in the database.

Sample

void set_parent( uint64_t message, uint64_t file )
{
   char id[40];

   truxton_file_get_parent_id( file, id, sizeof(id) );

   truxton_message_set_parent_id( message, id );
}