Truxton location save - Revision history

Sam at 10:51, 10 February 2021

2021-02-10T10:51:09Z

Sam at 12:55, 26 January 2021

2021-01-26T12:55:52Z

Sam at 11:55, 13 December 2020

2020-12-13T11:55:25Z

Sam: Created page with "This will commit the data in the location object to the database. It will write a record to the `[Location]` ta..."

2020-12-13T11:39:07Z

Created page with "This will commit the data in the location object to the database. It will write a record to the <code><nowiki>[</nowiki>Location<nowiki>]</nowiki></code> ta..."

New page

This will commit the data in the location object to the database.
It will write a record to the <code><nowiki>[</nowiki>[[Location Table|Location]]<nowiki>]</nowiki></code> table.

=Syntax=
<source lang="C">
int truxton_location_save( uint64_t location );
</source>

=Parameters=
==<code>location</code>==
The handle to the location object.
This handle comes from calling <code>[[truxton_location_create]]()</code> or <code>[[truxton_child_file_create_location]].

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

=Remarks=
After this call succeeds, the <code>[[truxton_location_id]]()</code>.

=Sample=
<source lang="C" highlight="30">
void add_folder(uint64_t truxton, uint64_t parent_file)
{
truxton_start_adding_files(truxton);

uint64_t child = truxton_child_file_create(truxton);

char id[40];

truxton_file_get_id(parent_file, id, sizeof(id));
truxton_child_file_set_parent_id(child, id);
truxton_child_file_set_type(child, Type_Directory);
truxton_child_file_set_name(child, "Custom Exploits Folder");

FILETIME now;

GetSystemTimePreciseAsFileTime(&now);

ULARGE_INTEGER ticks;

ticks.LowPart = now.dwLowDateTime;
ticks.HighPart = now.dwHighDateTime;

truxton_child_file_set_created(child, ticks.QuadPart);
truxton_child_file_set_accessed(child, ticks.QuadPart);
truxton_child_file_set_modified(child, ticks.QuadPart);

truxton_child_file_set_origin(child, ORIGIN_GENERATED);
truxton_child_file_set_media_id(child, "B57140A0-8E84-4500-B4D5-3606AA8560AA" );

if ( truxton_child_file_save(child) == 0 )
{
printf( "Failed to add child to Truxton\n" );
}

truxton_child_file_destroy(child);
}
</source>

@@ Line 20: / Line 20: @@
 =Sample=
 <source lang="C" highlight="19">
-void new_location(uint64_t truxton, uint64_t file, double latitude, double longitude, double altitude, uint64_t when)
+void new_location( uint64_t truxton, uint64_t file, double latitude, double longitude, double altitude, uint64_t when )
+{
     char guid_string[ 40 ];
-    uint64_t location = truxton_location_create(truxton);
+    uint64_t location = truxton_location_create( truxton );
     truxton_file_get_id( file, guid_string, sizeof( guid_string ) );
@@ Line 48: / Line 48: @@
+    }
-    truxton_location_destroy(location);
+    truxton_location_destroy( location );
+}
 </source>

@@ Line 16: / Line 16: @@
 =Remarks=
-After this call succeeds, the <code>[[truxton_location_get_id]]()</code>.
+After this call succeeds, the <code>[[truxton_location_get_id]]()</code> function will return a valid [https://en.wikipedia.org/wiki/Universally_unique_identifier GUID] which corresponds to the <code>[ID]</code> column of the <code><nowiki>[</nowiki>[[Location Table|Location]]<nowiki>]</nowiki></code> table.
 =Sample=
-<source lang="C" highlight="5">
+<source lang="C" highlight="19">
 void new_location(uint64_t truxton, uint64_t file, double latitude, double longitude, double altitude, uint64_t when)
+{

@@ Line 10: / Line 10: @@
 ==<code>location</code>==
 The handle to the location object.
-This handle comes from calling <code>[[truxton_location_create]]()</code> or <code>[[truxton_child_file_create_location]].
+This handle comes from calling <code>[[truxton_location_create]]()</code> or <code>[[truxton_child_file_create_location]]()</code>.
 =Return value=
@@ Line 16: / Line 16: @@
 =Remarks=
-After this call succeeds, the <code>[[truxton_location_id]]()</code>.
+After this call succeeds, the <code>[[truxton_location_get_id]]()</code>.
 =Sample=
-<source lang="C" highlight="30">
+<source lang="C" highlight="5">
-void add_folder(uint64_t truxton, uint64_t parent_file)
+void new_location(uint64_t truxton, uint64_t file, double latitude, double longitude, double altitude, uint64_t when)
+{
-    truxton_start_adding_files(truxton);
+    char guid_string[ 40 ];
-    uint64_t child = truxton_child_file_create(truxton);
+    uint64_t location = truxton_location_create(truxton);
-    char id[40];
+    truxton_file_get_id( file, guid_string, sizeof( guid_string ) );
-    truxton_file_get_id(parent_file, id, sizeof(id));
+    truxton_file_get_media_id( file, guid_string, sizeof( guid_string ) );
-    truxton_child_file_set_parent_id(child, id);
+    truxton_location_set_media_id( location, guid_string );
-    FILETIME now;
+    truxton_location_set_latitude( location, latitude );
-    GetSystemTimePreciseAsFileTime(&now);
+    if ( truxton_location_save() == 0 )
-−
+    {
-   ULARGE_INTEGER ticks;
+      printf( "Failed to create new location\n" );
-−
+   }
-   ticks.LowPart = now.dwLowDateTime;
+    else
+    {
-       printf( "Failed to add child to Truxton\n" );
+      truxton_location_get_id( location, guid_string, sizeof( guid_string ) );
+    }
-    truxton_child_file_destroy(child);
+    truxton_location_destroy(location);
+}
 </source>

Truxton location save - Revision history

Sam at 10:51, 10 February 2021

Sam at 12:55, 26 January 2021

Sam at 11:55, 13 December 2020

Sam: Created page with "This will commit the data in the location object to the database. It will write a record to the [Location] ta..."

Sam: Created page with "This will commit the data in the location object to the database. It will write a record to the `[Location]` ta..."