Truxton message address set name

Sets the name associated with the message address.

Syntax

void truxton_message_address_set_name( uint64_t address_handle, char const * name );

Parameters

address_handle

The handle created by the truxton_message_address_create call.

name

The name part of the address.

Sample

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);
}