Truxton group get id - Revision history

Sam: /* group_handle */

2024-04-11T10:01:56Z

group_handle

Sam at 09:53, 11 April 2024

2024-04-11T09:53:48Z

Sam at 09:49, 11 April 2024

2024-04-11T09:49:17Z

Sam: Created page with "This creates a group in Truxton. =Syntax= void truxton_group_get_id(uint64_t group_handle, char * destination_string, size_t max_size); =Paramete..."

2024-04-11T09:48:11Z

Created page with "This creates a group in Truxton. =Syntax= <source lang="C"> void truxton_group_get_id(uint64_t group_handle, char * destination_string, size_t max_size); </source> =Paramete..."

New page

This creates a group in Truxton.

=Syntax=
<source lang="C">
void truxton_group_get_id(uint64_t group_handle, char * destination_string, size_t max_size);
</source>

=Parameters=
==<code>group_handle</code>==
The handle created by by <code>[[truxton_group_create]]()</code>.

==<code>destination_string</code>==
The string to be written to.

==<code>max_size</code>==
The maximum number of characters that can be written to <code>destination_string</code>.

=Sample=
<source lang="C" highlight="9" line>
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_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 );
}
</source>

← Older revision		Revision as of 09:53, 11 April 2024
Line 1:		Line 1:
−	This ~~creates a group in Truxton~~.	+	Retrieves the globally unique identifier of the group.
		+	This corresponds to the <code>[ID]</code> column of the <code>[Group]</code> table.

	=Syntax=		=Syntax=

@@ Line 9: / Line 9: @@
 =Parameters=
 ==<code>group_handle</code>==
-The handle created by by <code>[[truxton_group_create]]()</code>.
+The handle created by <code>[[truxton_group_create]]()</code> or <code>[[truxton_investigation_create_group]]()</code>.
 ==<code>destination_string</code>==

@@ Line 3: / Line 3: @@
 =Syntax=
 <source lang="C">
-void truxton_group_get_id(uint64_t group_handle, char * destination_string, size_t max_size);
+void truxton_group_get_id( uint64_t group_handle, char * destination_string, size_t max_size );
 </source>
@@ Line 17: / Line 17: @@
 =Sample=
-<source lang="C" highlight="9" line>
+<source lang="C" highlight="20">
 void create_my_things(uint64_t investigation_handle)
+{