Share via


IVMAccessRights interface

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

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

See also

IDispatch

Microsoft Virtual Server 2005 Reference

IVMAccessRights Methods

IVMAccessRights Properties