Truxton group get investigator id

From truxwiki.com
Revision as of 06:22, 12 April 2024 by Sam (talk | contribs) (Created page with "This retrieves the globally unique identifier of the investigator that created this group. This corresponds to the <code>[InvestigatorID]</code> column of the <code>[Group]</c...")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

This retrieves the globally unique identifier of the investigator that created this group. This corresponds to the [InvestigatorID] column of the [Group] table.

Syntax

void truxton_group_get_investigator_id( uint64_t group_handle, char * destination_string, size_t max_size );

Parameters

group_handle

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

destination_string

The string to be written to.

max_size

The maximum number of characters that can be written to destination_string.

Sample

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

    uint64_t group_handle = truxton_investigation_create_group( investigation_handle);
 
    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_get_investigator_id( group, guid, sizeof(guid) );
        printf( "Investigator: %s\n", guid );
    }

    truxton_group_destroy( group_handle );
}