For information on converting to InterSystems IRIS, see the
InterSystems IRIS Adoption Guide
and the InterSystems IRIS In-Place Conversion Guide,
both available on the WRC Distributions page (login required).
Impersonates the user logged on by the LogonUser() method by calling the Windows ImpersonateLoggedOnUser() API with the security token saved by LogonUser().
ImpersonateUser() and RevertToSelf do not affect the Cache user context contained in $USERNAME.
Returns 0 on success, -1 if no security token has been saved, or the value returned by GetLastError() on failure.
Calls the Windows LogonUser() API and saves the security token for the current process.
The user context is unaffected until the ImpersonateUser() method is called.
Return value is 0 on success or the error value retrieved from GetLastError() on failure.
This method is only available on Windows platforms.
It cannot be called from a local Cache Terminal process which displays TRM:pid (InstanceName) in the title bar because this process is already impersonating the logged in Windows user.
An attempt to call LogonUser() from a local terminal process will result in a error.
Returns the X.509 certificate used
to verify the peer for the SSL/TLS session running over the current
principal TCP device, in binary DER format. The certificate can be used as
input to $System.Encryption.X509GetField() and the RSA* functions.
To save the certificate to a file in PEM format:
Do file.Write("-----BEGIN CERTIFICATE-----"_$c(13,10))
Do file.Write($c(13,10)_"-----END CERTIFICATE-----"_$c(13,10))
Returns a string representation of the X.500 distinguished name contained in the X.509 certificate used
to verify the peer for the SSL/TLS session running over the
principal device. Called with no arguments it returns the entire
name on one line. Called with an optional argument specifying a component
name entry it retuns just that entry, if present. Legal values for the
entry argument, and their legal short abreviations, are:
If the principal device is a TCP device, peek into the TCP receive buffer.
Returns 1 if it contains an SSLv3 or TLSv1 Client Hello message, or
an SSLv2 Client Hello message requesting SSLv3 or later.
Otherwise returns 0.
Set the SSL requirement (Disabled/Enabled/Required) for inbound connections on the Caché %Service_Telnet service.
The default value is 1 (Enabled) if a %TELNET/SSL configuration exists is enabled.
The default value is 0 (Disabled) of no %TELNET/SSL configuration exists or is enabled.
This method can be called from SYSTEM^%ZSTART to establish the setting for an instance at startup.
This setting is only applicable on the Windows platform. Valid inputs are: