Truxton usb get id

This retrieves the GUID of the USB object. This call is only valid after a successful call to truxton_usb_save(). This corresponds to the [ID] column of the [USBDevice] table.

Syntax

void truxton_usb_get_id( uint64_t usb_handle, char * destination_string, size_t max_size );

Parameters

usb_handle

This handle comes from calling truxton_usb_create().

destination_string

The string to be written to.

max_size

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

Sample

void add_thumb_drive( uint64_t truxton, uint64_t media, uint64_t child_file, uint64_t when, uint64_t where )
{
   char media_id[ 65 ];
   char file_id[ 65 ];
   char usb_id[ 65 ];
   
   truxton_media_get_id( media, media_id, sizeof( media_id ) );
   truxton_child_file_get_id( child_file, file_id, sizeof( file_id ) );

   uint64_t usb = truxton_usb_create( truxton );

   truxton_usb_set_file_id( usb, file_id );
   truxton_usb_set_media_id( usb, media_id );
   truxton_usb_set_when( usb, when );
   truxton_usb_set_vendor_id( usb, 0x8EC );
   truxton_usb_set_product_id( usb, 0x16 );
   truxton_usb_set_file_offset( usb, where );

   // Commit the data to the database
   if ( truxton_usb_save( usb ) == 0 )
   {
      printf( "Cannot save USB to the database\n" );
   }
   else
   {
      truxton_usb_get_id( usb, usb_id, sizeof( usb_id ) );
      printf( "USB information saved to record id %s\n", usb_id );
   }

   truxton_usb_destroy( usb );
}