Skip to main content

NewGuidString

Function NewGuidString: string

Example​

procedure ScriptEvent(var Value: variant);
begin
  Value := NewGuidString;
  // Shape: {XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX}
end;

Usage​

NewGuidString requests a new Windows UUID and returns Velox's uppercase brace-wrapped string form.

Returns

A string shaped as {XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX}, with uppercase hexadecimal, four hyphens and two braces.

Important usage notes

  • Output shape is deterministic; output value is not.
  • The string always contains braces and uppercase hex in Velox.
  • A successful string allocation does not prove that Windows reported RPC_S_OK because status was discarded earlier.
  • The UUID is an identifier, not a secret or authentication credential.
  • No collision check is performed against Velox configuration or database contents.
  • Do not assume lexical sort order represents creation order.

Additional Technical Info​

NewGuidString requests a Windows UUID through NewGuid and formats the resulting record in Delphi's 38-character uppercase brace-wrapped form.

The example shows only the shape because the value is nondeterministic. It is source-reviewed and was not executed by the documentation workflow.

Implementation

The function evaluates GUIDToString(NewGuid). NewGuid calls Delphi CreateGUID but discards its status; installed Windows Delphi reaches rpcrt4!UuidCreate. Installed GUIDToString then formats whatever TGuid record was returned.

Formatting a record cannot restore the discarded generation status. Even an all-zero or otherwise unexpected record has a valid 38-character text representation.

Side effects and errors

Calls Windows UUID services and allocates a string. Velox performs no persistence. Nonzero generation statuses are not raised; delayed runtime/DLL and allocation failures may propagate.

Performance and concurrency

One OS call plus constant-size formatting. No Velox shared counter/state.

Related entries

External references

Created 2026-07-15