Changeset 11961 in vbox for trunk

Timestamp:

Sep 2, 2008 8:10:46 AM (16 years ago)

Author:

vboxsync

Message:

VRDPAuth.h: explain binary UUID representation in comment

File:

• trunk/include/VBox/VRDPAuth.h (modified) (1 diff)

trunk/include/VBox/VRDPAuth.h

@@ -54 +54 @@
 typedef unsigned char VRDPAUTHUUID[16];
 typedef VRDPAUTHUUID *PVRDPAUTHUUID;
-
+/*
+Note: VirtualBox uses a consistent binary representation of UUIDs on all platforms. For this reason
+the integer fields comprising the UUID are stored as little endian values. If you want to pass such
+UUIDs to code which assumes that the integer fields are big endian (often also called network byte
+order), you need to adjust the contents of the UUID to e.g. achieve the same string representation.
+The required changes are:
+ * reverse the order of byte 0, 1, 2 and 3
+ * reverse the order of byte 4 and 5
+ * reverse the order of byte 6 and 7.
+Using this conversion you will get identical results when converting the binary UUID to the string
+representation.
+*/
 
 /* The library entry point calling convention. */