VLScontrolRemoteSession
Syntax
LS_STATUS_CODE VLScontrolRemoteSession ( inttoCheckRemoteSession);
| Argument | Description |
|
toCheckRemoteSession |
Specifies whether the use of the licensed application through remote sessions will be allowed or not. Allowed values are: >VLS_ON (default) - Access not allowed through terminal sessions, but allowed through RDP connections. >VLS_OFF - Access allowed through both terminal sessions and Windows RDP connections. >VLS_CONTROL_RDP_OFF - Access not allowed through terminal sessions, but allowed through RDP connections. >VLS_CONTROL_RDP_ON - Access not allowed through terminal sessions and RDP connections. |
Description
Allows or prohibits use of the licensed application through remote sessions in the standalone licensing environments.
Using this function, you can allow or prohibit the use of applications through remote sessions. Prior to RMS v8.5.1 for Windows, this check was limited to terminal clients only. Thereafter, this check applies to Windows RDP connections as well.
Make sure that you call this API function before calling VLSinitialize.
Returns
The status code LS_SUCCESS is returned if successful. Otherwise, it will return the following error codes:
|
Error Code |
Description |
|
VLS_CALLING_ERROR |
If the input parameter is other than the flags defined above. |
|
VLS_RESOURCE_LOCK_FAILURE |
Failed to fetch the API resource lock. On receiving this error, retry calling this API. |
|
VLS_NOT_SUPPORTED_IN_NET_ONLY_MODE |
When the function is called in an application linked to a network only library. |
For a complete list of the error codes, see Licensing Library Error and Result Codes.