GetGUID

Description:              This function creates a globally unique identifier or converts an existing GUID to another format.

Returns:                    Text

Usage:                       Script

Format:                      GetGUID(Format [, ExistingGUID])

Parameters:             Format      { numeric }  { required }  { no default }

                                              Any numeric expression giving that defines the format of the return value as follows:

Format

Format definition

0

36 byte ASCII string

1

16 byte binary string

 

                                    ExistingGUID  { text }  { optional }  { no default }

                                              An optional parameter that is any text expression for the GUID to be converted from one format to another.

Comments:               Any generated GUID will be different from all others generated on this or any other machine now or in the future. It is particularly useful in generating unique variable or file names.

Example:

If 1 Main;

[

  GUID1 = GetGUID(1); 

  GUID2 = GetGUID(0, GUID1); 

]

The above script will cause GUID1 to be set to a globally unique 16 bit binary string and GUID2 to convert GUID1 to its 36 byte ASCII string equivalent.