xml.Encryption.getEmbeddedKey

Get a copy of the embedded symmetric key that was used in the last decryption operation.

Syntax

getEmbeddedKey()
  RETURNING key xml.CryptoKey

Usage

Returns a copy of the embedded symmetric key that was used in the last decryption operation, or NULL if there is none.

An embedded symmetric key is always encrypted, and needs therefore a key-encryption key to be set in order to decrypt it.

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).