Difference between revisions of "Truxton group set id"

From truxwiki.com
Jump to navigation Jump to search
(Created page with "This sets the globally unique identifier for the group. =Syntax= <source lang="C"> void truxton_group_set_id( uint64_t group_handle, char const * guid ); </source> =Paramete...")
 
 
Line 1: Line 1:
 
This sets the globally unique identifier for the group.
 
This sets the globally unique identifier for the group.
 +
This corresponds to the <code>[ID]</code> column of the <code>[Group]</code> table.
  
 
=Syntax=
 
=Syntax=

Latest revision as of 06:08, 12 April 2024

This sets the globally unique identifier for the group. This corresponds to the [ID] column of the [Group] table.

Syntax

void truxton_group_set_id( uint64_t group_handle, char const * guid );

Parameters

group_handle

The handle created by truxton_group_create() or truxton_investigation_create_group().

guid

The string representation of a globally unique identifier.

Sample

void create_my_things(uint64_t investigation_handle)
{
    if (investigation_handle == 0)
    {
        return;
    }

    uint64_t truxton_handle = truxton_investigation_get_truxton( investigation_handle );
    uint64_t group_handle = truxton_group_create( truxton_handle );
 
    truxton_group_set_id( group_handle, "47726F75-7020-5361-6D70-6C65636F6465" );
    truxton_group_set_name( group_handle, "My Things" );
    truxton_group_set_description( group_handle, "These are my things" );
    truxton_group_set_is_default( group_handle, 1 );
    truxton_group_set_type( group_handle, GROUP_TYPE_USER );

    if ( truxton_group_save( group_handle ) != 0 )
    {
        char guid[MINIMUM_GUID_STRING_BUFFER_SIZE + 5];

        truxton_group_get_id( group_handle, guid, sizeof(guid) );
        truxton_investigation_set_active_group_id( investigation_handle, guid );
    }

    truxton_group_destroy( group_handle );
}