Sam: Created page with "This creates a message address object. You can use this to add records to the `[Account]`, `[MessageAddress..."`


2024-04-24T09:41:22Z
Created page with "This creates a message address object. You can use this to add records to the <code><nowiki>[</nowiki>Account<nowiki>]</nowiki></code>, <code>[MessageAddress..."
New page
This creates a message address object.

You can use this to add records to the <code><nowiki>[</nowiki>[[Account Table|Account]]<nowiki>]</nowiki></code>, <code>[MessageAddress]</code>, <code>[MessageAddressDescription]</code>, and <code>[Server]</code> tables in the database.



=Syntax=

<source lang="C">

uint64_t truxton_message_address_create( uint64_t truxton_handle );

</source>



=Parameters=

==<code>truxton_handle</code>==

The Truxton instance this address will belong.

This handle comes from calling <code>[[truxton_create]]()</code>.



=Return value=

A handle to a message address object.



=Sample=

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

void add_address( uint64_t truxton )

{

   uint64_t address = truxton_message_address_create(truxton);



   truxton_message_address_set_account(address, "sammy");

   truxton_message_address_set_server(address, "abc.com");

   truxton_message_address_set_name(address, "Graham Throatwarblermangrove");



   if (truxton_message_address_save(address) == 0)

   {

      printf( "Failed to add message address to Truxton\n" );

      return;

   }



   char combined_guid[65];

   char id[65];

   char account[128];

   char server[128];

   char name[128];



   uint64_t combined_id = truxton_message_address_get_combined_id(address);



   truxton_message_address_get_id(address, id, sizeof(id));

   truxton_message_address_get_combined_guid(address, combined_guid, sizeof(combined_guid));

   truxton_message_address_get_name(address, name, sizeof(name));

   truxton_message_address_get_account(address, account, sizeof(account));

   truxton_message_address_get_server(address, server, sizeof(server));



   printf("%s <%s@%s>\n", name, account, server);

   printf("Database ID: %s\n", id);

   printf("Combined ID: %I64u\n", combined_id);

   printf("Combined GUID: %s\n", combined_guid);



   truxton_message_address_destroy(address);

}

</source>

Truxton message address create - Revision history

Sam: Created page with "This creates a message address object. You can use this to add records to the [Account], [MessageAddress..."

Sam: Created page with "This creates a message address object. You can use this to add records to the `[Account]`, `[MessageAddress..."`