VLScgSetVmDetection

Syntax

int VLScgSetVmDetection (VLScg_HANDLE iHandle, codeT *codeP, char *vmDetectionStr);
Argument Description

iHandle

The instance handle for this library.

codeP

The pointer to the codeT struct.

vmDetectionStr

The buffer used to set the virtual machine detection flag for clients. The valid values are:

>VLScg_VM_ALLOWED_STRING - Issue license token on virtual machine detection = “0”

>VLScg_VM_DISALLOWED_STRING - Do not issue license token on virtual machine detection = “1”

Description

Sets the action on detection of a virtual machine—whether to allow\deny a license token.

This check is done only when the RMS License Manager starts up, however, the License Manager does not exit on detection of a virtual machine on the host. Only those licenses that disallow license use (in the case of VM detection) are denied.

Returns

The status code VLScg_SUCCESS is returned if successful. Otherwise, it will return the following error codes:

Error Code

Description

VLScg_INVALID_INPUT

If value is not any one of the above defined flags.

For the complete list of the error codes, refer to License Generation and Revocation Error Codes .