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 |
|