Truxton enumeration get scope - Revision history

Sam: /* Sample */

2024-02-03T14:51:54Z

Sample

Sam at 09:44, 22 May 2023

2023-05-22T09:44:13Z

Sam at 09:39, 22 May 2023

2023-05-22T09:39:55Z

Sam: Created page with "Retrieves the next item in the enumeration. =Syntax= uint64_t truxton_enumeration_get_scope( uint64_t enumeration_handle ); =Parameters= ==`..."`


2023-05-22T09:39:04Z
Created page with "Retrieves the next item in the enumeration.  =Syntax= <source lang="C"> uint64_t truxton_enumeration_get_scope( uint64_t enumeration_handle ); </source>  =Parameters= ==<code>..."
New page
Retrieves the next item in the enumeration.



=Syntax=

<source lang="C">

uint64_t truxton_enumeration_get_scope( uint64_t enumeration_handle );

</source>



=Parameters=

==<code>enumeration_handle</code>==

The handle returned by calling <code>[[truxton_enumeration_create]]()</code>.



=Return value=

The scope of the enumeration.



=Sample=

<source lang="C" highlight="5">

void print_details( uint64_t enumerator )

{

   char uuid[40];



   uint64_t scope = truxton_enumeration_get_scope( enumerator );

   uint64_t target = truxton_enumeration_get_target( enumerator );



   truxton_enumeration_get_scope_id( enumerator, uuid, sizeof( uuid ) );



   printf( "%" PRIu64 " - %s - %" PRIu64 "\n", scope, scope_id, target );

}



void main()

{

    char investigation_name[256];



    truxton_start();



    uint64_t truxton = truxton_create();



    uint64_t enumerator = truxton_enumeration_create( truxton );



    truxton_enumeration_set_target( enumerator, Type_Investigation );



    uint64_t investigation_handle = truxton_enumeration_get_next( enumerator );



    uint64_t count = 0;



    print_details( enumerator );



    while( investigation_handle != 0 )

    {

        count++ 

        investigation_handle = truxton_enumeration_get_next( enumerator );

    }



    printf( "%" PRIu64 " investigations\n", count );



    truxton_enumeration_destroy( enumerator );

    truxton_destroy( truxton );

    truxton_stop();

}

</source>

← Older revision		Revision as of 09:44, 22 May 2023
Line 1:		Line 1:
−	Retrieves the ~~next item in~~ the enumeration.	+	Retrieves the scope of the enumeration.

	=Syntax=		=Syntax=

← Older revision		Revision as of 09:39, 22 May 2023
Line 58:		Line 58:
	}		}
	</source>		</source>
		+
		+
		+	The <code>PRIu64</code> in the sample code above is a standard way of [https://en.wikipedia.org/wiki/C_data_types#Printf_and_scanf_format_specifiers formatting] a 64-bit unsigned integer in C.
		+	Over the years, different compilers on different operating systems used different format specifiers for things, these <code>PRI</code> macros, along with some tricky string concatenation the compilers perform for you, allow you to maintain a single code base without a bunch of macro magic.

Truxton enumeration get scope - Revision history

Sam: /* Sample */

Sam at 09:44, 22 May 2023

Sam at 09:39, 22 May 2023

Sam: Created page with "Retrieves the next item in the enumeration. =Syntax= uint64_t truxton_enumeration_get_scope( uint64_t enumeration_handle ); =Parameters= ==..."

Sam: Created page with "Retrieves the next item in the enumeration. =Syntax= uint64_t truxton_enumeration_get_scope( uint64_t enumeration_handle ); =Parameters= ==`..."`