Difference between revisions of "Truxton group set investigator id"

From truxwiki.com
Jump to navigation Jump to search
(Created page with "This sets the globally unique identifier for the group. This corresponds to the <code>[InvestigatorID]</code> column of the <code>[Group]</code> table. =Syntax= <source lang=...")
 
 
Line 13: Line 13:
 
==<code>guid</code>==
 
==<code>guid</code>==
 
The string representation of a globally unique identifier.
 
The string representation of a globally unique identifier.
 +
This value should match an entry in the <code>[ID]</code> column of the <code>[Investigator]</code> table.
  
 
=Sample=
 
=Sample=

Latest revision as of 17:08, 12 April 2024

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

Syntax

void truxton_group_set_investigator_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. This value should match an entry in the [ID] column of the [Investigator] table.

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