GetGUID

Description: Creates a globally unique identifier or converts an existing GUID to another format.
Returns: Text
Usage: Script only.
Function Groups: Network
Related to:  
Format: GetGUID(Format [, ExistingGUID])
Parameters:  
Format
Required. 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
An optional parameter that is any text expression for the GUID to be converted from one format to another. No default value.
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.

The current application's GUID is stored in \LocalGUID, using the 16-byte binary form.

Example:

The following 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.

If 1 Main;
[
  GUID1 = GetGUID(1);
  GUID2 = GetGUID(0, GUID1);
]

The next example obtains the current application's existing GUID as a 32-character string.

If 1 Main;
[
  MyGUID = GetGUID(0,\LocalGUID);
]