IVMAccessRights interface

Article
05/31/2018

The IVMAccessRights interface defines the access rights for a particular account or group.

Members

The IVMAccessRights interface inherits from the IDispatch interface. IVMAccessRights also has these types of members:

Methods
Properties

Methods

The IVMAccessRights interface has these methods.

Method	Description
_GetAccessMask	Retrieves the access rights as a bitmask.

Properties

The IVMAccessRights interface has these properties.

Property	Access type	Description
ChangePermissions	Read/write	Indicates whether this entry controls the ability to change permissions.
DeleteAccess	Read/write	Indicates whether this entry controls delete access.
ExecuteAccess	Read/write	Indicates whether this entry controls execute access.
Flags	Read/write	The access control entry flags.
Name	Read/write	The account name of the user or group.
ReadAccess	Read/write	Indicates whether this entry controls read access.
ReadPermissions	Read/write	Indicates whether this entry controls the ability to read permissions.
Sid	Read/write	The SID string of the user or group.
SpecialAccess	Read/write	Indicates whether this entry controls permissions not mapped to generic read, write or execute access rights.
Type	Read/write	The type of access control entry.
WriteAccess	Read/write	Indicates whether this entry controls write access.

Remarks

The properties WriteAccess, ReadAccess, and ExecuteAccess control generic access rights to the protected object. For example, granting WriteAccess to a virtual machine sets the rights represented by the FILE_GENERIC_WRITE constant on the virtual machines configuration file. If a set of rights cannot be mapped to a generic access right, the SpecialAccess property will return VARIANT_TRUE. Although no ability to change the special access rights is provided by this interface, the rights will be preserved in the entry. You retrieve an IVMAccessRights instance from the IVMAccessRightsCollection of an IVMSecurity instance protecting a given resource.

Examples

The following example prints the access right properties of the access control entries from the security object protecting access to the COM interfaces and global settings.

Dim vsApp
Dim vsSecurity
Dim vsAccessRights
Dim arProperty

Set vsApp = WScript.CreateObject("VirtualServer.Application")
Set vsSecurity = vsApp.Security
Set vsAccessRights = vsSecurity.AccessRights

For Each arProperty In vsAccessRights
  Wscript.Echo "Name: " & arProperty.Name
  Wscript.Echo "Change permissions: " & arProperty.ChangePermissions
  Wscript.Echo "Delete access: " & arProperty.DeleteAccess
  Wscript.Echo "Execute access: " & arProperty.ExecuteAccess
  Wscript.Echo "Flags: " & arProperty.Flags
  Wscript.Echo "Read access: " & arProperty.ReadAccess
  Wscript.Echo "Read permissions: " & arProperty.ReadPermissions
  Wscript.Echo "SID: " & arProperty.SID
  Wscript.Echo "Special access: " & arProperty.SpecialAccess
  Wscript.Echo "Type: " & arProperty.Type
  Wscript.Echo "Write access: " & arProperty.WriteAccess
  Wscript.Echo
Next

Requirements


Product	Microsoft Virtual Server 2005 onWindows Server 2003
Download	Microsoft Virtual Server 2005 R2 SP1 Update onWindows Server 2008orWindows Server 2003
Header	VsComInterfaces.h

Share via