xml.CryptoKey.compareTo

Compares a CryptoKey object to a second key.

Syntax

compareTo(
   toCompare xml.CryptoKey )
  RETURNS INTEGER
  1. toCompare defines the xml.CryptoKey object to use for comparison to the current CryptoKey object.

Usage

The method verifies if the key's URL, type, size, usage and value are the same. If they are the same, the two identical keys will produce the same encryption cipher.

The key features are not taken into account during comparison.

Returns TRUE if they are identical, FALSE if they are not identical.

In case of error, the method throws an exception and sets the STATUS variable. Depending on the error, a human-readable description of the problem is available in the SQLCA.SQLERRM register. See Error handling in GWS calls (STATUS).