PrlAcl_SetAccessForOthers Function

Sets access rights on a virtual machine.

Syntax

PRL_RESULT PrlAcl_SetAccessForOthers(
    PRL_HANDLE hAcl, 
    PRL_VM_ACCESS_FOR_OTHERS nAccessForOthers
);

File

PrlApiVm.h

Parameters

hAcl

A handle of type PHT_ACCESS_RIGHTS containing the access rights information for a virtual machine.

nAccessForOthers

The access rights to set.

Returns

PRL_RESULT. Possible values:

PRL_ERR_INVALID_ARG - invalid handle or null pointer was passed.

PRL_ERR_SUCCESS - function completed successfully.

Remarks

The owner of a virtual machine can use this function to grant or deny access rights for the virtual machine to other users. The access rights will be applied to all users. The call will only update the local copy of the PHT_ACCESS_RIGHTS object passed to the function (you will have to properly obtain the object prior to calling this function). To apply the changes to the virtual machine, call the PrlVm_UpdateSecurity function after making this calls and pass the same PHT_ACCESS_RIGHTS handle to it.