Returns the handle to a copy of the sealed client-principal object that represents the user identity for the ABL session. If no identity has been established for the session using the SECURITY-POLICY:
SET-CLIENT( ) method, this method returns the Unknown value (
?).
You can use the client-principal object returned by this function to set the user's identity for other ABL sessions or database connections.
To avoid a memory leak, you must explicitly delete the client-principal object whose handle is returned by this method when you no longer need it.
This method does not raise an ERROR condition unless it encounters an unexpected internal error.