Truxton enumeration create

Creates an enumeration object.

Syntax

uint64_t truxton_enumeration_create( uint64_t truxton_handle );

Return value

A non-zero value on success, zero on failure.

Sample

 1 void dump_media_in_investigation( uint64_t truxton_handle, uint64_t investigation_handle )
 2 {
 3     char media_name[ 256 ];
 4     char investigation_id[ 65 ];
 5 
 6     truxton_investigation_get_id( investigation_handle, investigation_id, sizeof( investigation_id ) );
 7 
 8     uint64_t enumerator = truxton_enumeration_create( truxton );
 9 
10     // Now setup the enumeration to get the media in a particular investigation
11     truxton_enumeration_set_scope( enumerator, Type_Investigation );
12     truxton_enumeration_set_scope_id( enumerator, investigation_id );
13     truxton_enumeration_set_target( enumerator, Type_Media );
14 
15     uint64_t media_handle = truxton_enumeration_get_next( enumerator );
16 
17     while( media_handle != 0 )
18     {
19         truxton_media_get_name( media_handle, media_name, sizeof( media_name ) );
20         printf( "Media: %s\n", media_name );
21 
22         media_handle = truxton_enumeration_get_next( enumerator );
23     }
24 
25     truxton_enumeration_destroy( enumerator );
26 }
27 
28 void main()
29 {
30     char investigation_name[256];
31 
32     truxton_start();
33 
34     uint64_t truxton = truxton_create();
35 
36     uint64_t enumerator = truxton_enumeration_create( truxton );
37 
38     truxton_enumeration_set_target( enumerator, Type_Investigation );
39 
40     uint64_t investigation_handle = truxton_enumeration_get_next( enumerator );
41 
42     while( investigation_handle != 0 )
43     {
44         truxton_investigation_get_name( investigation_handle, investigation_name, sizeof( investigation_name ) );
45 
46         printf( "Investigation: %s\n", investigation_name );
47 
48         dump_media_in_investigation( truxton, investigation_handle );
49 
50         investigation_handle = truxton_enumeration_get_next( enumerator );
51     }
52 
53     truxton_enumeration_destroy( enumerator );
54     truxton_destroy( truxton );
55     truxton_stop();
56 }