Back to Contents

The Util class

Summary:

See also: The Genero Web Services COM Library

Syntax

The Util class provides static helper methods. Notice that status is set to zero after a successful method call.

Syntax

com.Util

Notes:

This class does not have to be instantiated.

Methods

Class Methods
Name Description
com.Util.CreateRandomString(
  size INTEGER )
   RETURNING STRING		 Generates a random binary data of size bytes long, and returns it into a string encoded in a Base64 form.

The size must be greater than 0.

The function is intended to be used when randomness is required, such as in deriveKey or CreateDigestString.

Throws an exception in case of errors, and updates status with an error code.

com.Util.CreateDigestString(
  password STRING,
  random STRING )
   RETURNING STRING		 Computes the digest from a password value and an optional random Base64 form string, and returns it into a string encoded in Base64 form.

The random value must be a valid Base64 String.

Throws an exception in case of errors, and updates status with an error code.

com.Util.CreateUUIDString()
   RETURNING STRING 		Computes an universal unique identifier and returns it as a 4GL string.

Throws an exception in case of errors, and updates status with an error code.

com.Util.UniqueApplicationInstance(
  path STRING)
   RETURNING INTEGER

Makes sure that the calling application is the only one to run, by trying to get an exclusive lock on the given file.

If the locking operation achieved, it returns 0. Otherwise, returns 1 and updates status with an error code.

In case of any errors, updates status with an error code.

Back to the top