View source for Truxton url get when

This retrieves the date and time when the URL was visited.
This corresponds to the <code>[When]</code> column of the <code><nowiki>[</nowiki>[[WebsiteVisit Table|WebsiteVisit]]<nowiki>]</nowiki></code> table.

=Syntax=
<source lang="C">
uint64_t truxton_url_get_when( uint64_t url_handle );
</source>

=Parameters=
==<code>url_handle</code>==
This handle comes from calling <code>[[truxton_url_create]]()</code>, or <code>[[truxton_file_create_url]]()</code>.

=Return value=
When the URL was visited in [https://docs.microsoft.com/en-us/windows/win32/api/minwinbase/ns-minwinbase-filetime FILETIME] ticks.

=Sample=
<source lang="C" highlight="50">
void dump_url( uint64_t url_handle )
{
   uint64_t integer_value = 0;

   char temp_string[ 1024 ];

   truxton_url_get_id( url_handle, temp_string, sizeof(temp_string) );
   printf( "URL ID is %s\n", temp_string );

   truxton_url_get_media_id( url_handle, temp_string, sizeof(temp_string) );
   printf( "Media ID is %s\n", temp_string );

   truxton_url_get_file_id( url_handle, temp_string, sizeof(temp_string) );
   printf( "File ID is %s\n", temp_string );

   truxton_url_get_account( url_handle, temp_string, sizeof(temp_string) );
   printf( "Account is \"%s\"\n", temp_string );

   integer_value = truxton_url_get_account_offset( url_handle );

   if ( integer_value == 0xFFFFFFFFFFFFFFFF )
   {
      printf( "Account offset is not known\n" );
   }
   else
   {
      printf( "Account offset is %" PRIu64 "\n", integer_value );
   }

   integer_value = truxton_url_get_url_offset( url_handle );

   if ( integer_value == 0xFFFFFFFFFFFFFFFF )
   {
      printf( "URL offset is not known, probably came from a SQLite database\n" );
   }
   else
   {
      printf( "URL offset is %" PRIu64 "\n", integer_value );
   }

   integer_value = truxton_url_get_format( url_handle );
   printf( "Format is %" PRIu64 "\n", integer_value );

   integer_value = truxton_url_get_method( url_handle );
   printf( "Method is %" PRIu64 "\n", integer_value );

   integer_value = truxton_url_get_type( url_handle );
   printf( "Type is %" PRIu64 "\n", integer_value );

   integer_value = truxton_url_get_when( url_handle );
   printf( "When is %" PRIu64 "\n", integer_value );
}
</source>