Truxton get device id - Revision history

Sam: /* Sample */

2024-02-03T14:53:55Z

Sample

Sam at 20:53, 20 May 2021

2021-05-20T20:53:29Z

Sam: /* Sample */

2021-02-10T15:04:47Z

Sample

Sam at 15:04, 10 February 2021

2021-02-10T15:04:12Z

Sam: /* Remarks */

2021-01-17T12:43:22Z

Remarks

Sam at 12:39, 17 January 2021

2021-01-17T12:39:20Z

Sam at 16:17, 26 July 2020

2020-07-26T16:17:50Z

Sam: Created page with "Retrieves the version of the Truxton application object. =Syntax= void truxton_get_device_id( uint64_t trutxon_handle, char * destination_string, s..."

2020-05-19T21:40:52Z

Created page with "Retrieves the version of the Truxton application object. =Syntax= <syntaxhighlight lang="C"> void truxton_get_device_id( uint64_t trutxon_handle, char * destination_string, s..."

New page

Retrieves the version of the Truxton application object.

=Syntax=
<syntaxhighlight lang="C">
void truxton_get_device_id( uint64_t trutxon_handle, char * destination_string, size_t max_size );
</syntaxhighlight>

=Parameters=
==<code>truxton_handle</code>==

The handle created by the [[truxton_create]] call.

==<code>destination_string</code>==

The string to be written to.

==<code>max_size</code>==
The maximum number of characters that can be written to <code>destination_string</code>

=Remarks=

A device ID in Truxton is a [https://en.wikipedia.org/wiki/Universally_unique_identifier GUID] that uniquely identifies the machine.
The source of this identifier is the [https://en.wikipedia.org/wiki/BIOS BIOS] of the computer running your program.
It can be retrieved using <code>[https://docs.microsoft.com/en-us/windows/win32/wmisdk/wmic wmic]</code> using these parameters:
<syntaxhighlight lang="CMD">
wmic path Win32_ComputerSystemProduct get UUID
</syntaxhighlight>

This identifier is also written to the <code>[[Depot#bios_id|bios_id]]</code> field of the header of a Depot File.

=Sample=

<syntaxhighlight lang="C" highlight="9">
void main()
{
char id[256];

truxton_start();

uint64_t truxton = truxton_create();

truxton_get_device_id(truxton, id, sizeof(id));

printf("%s\n", id);

truxton_destroy(truxton);

truxton_stop();
}
</syntaxhighlight>

@@ Line 3: / Line 3: @@
 =Syntax=
 <source lang="C">
-void truxton_get_device_id( uint64_t trutxon_handle, char * destination_string, size_t max_size );
+void truxton_get_device_id( uint64_t truxton_handle, char * destination_string, size_t max_size );
 </source>

@@ Line 38: / Line 38: @@
      truxton_get_device_id( truxton, id, sizeof(id) );
-     printf("%s\n", id);
+     printf( "%s\n", id );
      truxton_destroy( truxton );

@@ Line 28: / Line 28: @@
 =Sample=
 <source lang="C" highlight="9">
-void main()
+void main( void )
+{
      char id[256];

@@ Line 36: / Line 36: @@
      uint64_t truxton = truxton_create();
-     truxton_get_device_id(truxton, id, sizeof(id));
+     truxton_get_device_id( truxton, id, sizeof(id) );
      printf("%s\n", id);
-     truxton_destroy(truxton);
+     truxton_destroy( truxton );
      truxton_stop();
+}
 </source>

@@ Line 17: / Line 17: @@
 =Remarks=
-A device ID in Truxton is a [https://en.wikipedia.org/wiki/Universally_unique_identifier GUID] that uniquely identifies the machine.
+A device ID in Truxton is a [https://en.wikipedia.org/wiki/Universally_unique_identifier GUID] that uniquely identifies the hardware.
 The source of this identifier is the [https://en.wikipedia.org/wiki/BIOS BIOS] of the computer running your program.
 It can be retrieved using <code>[https://docs.microsoft.com/en-us/windows/win32/wmisdk/wmic wmic]</code> using these parameters:

@@ Line 1: / Line 1: @@
-Retrieves the version of the Truxton application object.
+Retrieves the identifier of the hardware Truxton is running on.
 =Syntax=
-<syntaxhighlight lang="C">
+<source lang="C">
 void truxton_get_device_id( uint64_t trutxon_handle, char * destination_string, size_t max_size );
-</syntaxhighlight>
+</source>
 =Parameters=
 ==<code>truxton_handle</code>==
 The handle created by the [[truxton_create]] call.
 ==<code>destination_string</code>==
 The string to be written to.
@@ Line 19: / Line 17: @@
 =Remarks=
 A device ID in Truxton is a [https://en.wikipedia.org/wiki/Universally_unique_identifier GUID] that uniquely identifies the machine.
 The source of this identifier is the [https://en.wikipedia.org/wiki/BIOS BIOS] of the computer running your program.
 It can be retrieved using <code>[https://docs.microsoft.com/en-us/windows/win32/wmisdk/wmic wmic]</code> using these parameters:
-<syntaxhighlight lang="bat">
+<source lang="bat">
 wmic path Win32_ComputerSystemProduct get UUID
-</syntaxhighlight>
+</source>
 This identifier is also written to the <code>[[Depot#bios_id|bios_id]]</code> field of the header of a Depot File.
 =Sample=
+<source lang="C" highlight="9">
 void main()
+{
@@ Line 48: / Line 44: @@
      truxton_stop();
+}
-</syntaxhighlight>
+</source>