ADS_RIGHTS_ENUM enumeration (iads.h)

The ADS_RIGHTS_ENUM enumeration specifies access rights assigned to an Active Directory object. The IADsAccessControlEntry.AccessMask property contains a combination of these values for an Active Directory object.

For more information and a list of possible access right values for file or file share objects, see File Security and Access Rights.

For more information and a list of possible access right values for registry objects, see Registry Key Security and Access Rights.

Syntax

typedef enum __MIDL___MIDL_itf_ads_0001_0048_0001 {
  ADS_RIGHT_DELETE = 0x10000,
  ADS_RIGHT_READ_CONTROL = 0x20000,
  ADS_RIGHT_WRITE_DAC = 0x40000,
  ADS_RIGHT_WRITE_OWNER = 0x80000,
  ADS_RIGHT_SYNCHRONIZE = 0x100000,
  ADS_RIGHT_ACCESS_SYSTEM_SECURITY = 0x1000000,
  ADS_RIGHT_GENERIC_READ = 0x80000000,
  ADS_RIGHT_GENERIC_WRITE = 0x40000000,
  ADS_RIGHT_GENERIC_EXECUTE = 0x20000000,
  ADS_RIGHT_GENERIC_ALL = 0x10000000,
  ADS_RIGHT_DS_CREATE_CHILD = 0x1,
  ADS_RIGHT_DS_DELETE_CHILD = 0x2,
  ADS_RIGHT_ACTRL_DS_LIST = 0x4,
  ADS_RIGHT_DS_SELF = 0x8,
  ADS_RIGHT_DS_READ_PROP = 0x10,
  ADS_RIGHT_DS_WRITE_PROP = 0x20,
  ADS_RIGHT_DS_DELETE_TREE = 0x40,
  ADS_RIGHT_DS_LIST_OBJECT = 0x80,
  ADS_RIGHT_DS_CONTROL_ACCESS = 0x100
} ADS_RIGHTS_ENUM;

Constants

ADS_RIGHT_DELETE Value: 0x10000 The right to delete the object.
ADS_RIGHT_READ_CONTROL Value: 0x20000 The right to read data from the security descriptor of the object, not including the data in the SACL.
ADS_RIGHT_WRITE_DAC Value: 0x40000 The right to modify the discretionary access-control list (DACL) in the object security descriptor.
ADS_RIGHT_WRITE_OWNER Value: 0x80000 The right to assume ownership of the object. The user must be an object trustee. The user cannot transfer the ownership to other users.
ADS_RIGHT_SYNCHRONIZE Value: 0x100000 The right to use the object for synchronization. This enables a thread to wait until the object is in the signaled state.
ADS_RIGHT_ACCESS_SYSTEM_SECURITY Value: 0x1000000 The right to get or set the SACL in the object security descriptor.
ADS_RIGHT_GENERIC_READ Value: 0x80000000 The right to read permissions on this object, read all the properties on this object, list this object name when the parent container is listed, and list the contents of this object if it is a container.
ADS_RIGHT_GENERIC_WRITE Value: 0x40000000 The right to read permissions on this object, write all the properties on this object, and perform all validated writes to this object.
ADS_RIGHT_GENERIC_EXECUTE Value: 0x20000000 The right to read permissions on, and list the contents of, a container object.
ADS_RIGHT_GENERIC_ALL Value: 0x10000000 The right to create or delete child objects, delete a subtree, read and write properties, examine child objects and the object itself, add and remove the object from the directory, and read or write with an extended right.
ADS_RIGHT_DS_CREATE_CHILD Value: 0x1 The right to create child objects of the object. The ObjectType member of an ACE can contain a GUID that identifies the type of child object whose creation is controlled. If ObjectType does not contain a GUID, the ACE controls the creation of all child object types.
ADS_RIGHT_DS_DELETE_CHILD Value: 0x2 The right to delete child objects of the object. The ObjectType member of an ACE can contain a GUID that identifies a type of child object whose deletion is controlled. If ObjectType does not contain a GUID, the ACE controls the deletion of all child object types.
ADS_RIGHT_ACTRL_DS_LIST Value: 0x4 The right to list child objects of this object. For more information about this right, see Controlling Object Visibility.
ADS_RIGHT_DS_SELF Value: 0x8 The right to perform an operation controlled by a validated write access right. The ObjectType member of an ACE can contain a GUID that identifies the validated write. If ObjectType does not contain a GUID, the ACE controls the rights to perform all valid write operations associated with the object.
ADS_RIGHT_DS_READ_PROP Value: 0x10 The right to read properties of the object. The ObjectType member of an ACE can contain a GUID that identifies a property set or property. If ObjectType does not contain a GUID, the ACE controls the right to read all of the object properties.
ADS_RIGHT_DS_WRITE_PROP Value: 0x20 The right to write properties of the object. The ObjectType member of an ACE can contain a GUID that identifies a property set or property. If ObjectType does not contain a GUID, the ACE controls the right to write all of the object properties.
ADS_RIGHT_DS_DELETE_TREE Value: 0x40 The right to delete all child objects of this object, regardless of the permissions of the child objects.
ADS_RIGHT_DS_LIST_OBJECT Value: 0x80 The right to list a particular object. If the user is not granted such a right, and the user does not have ADS_RIGHT_ACTRL_DS_LIST set on the object parent, the object is hidden from the user. This right is ignored if the third character of the dSHeuristics property is '0' or not set. For more information, see Controlling Object Visibility.
ADS_RIGHT_DS_CONTROL_ACCESS Value: 0x100 The right to perform an operation controlled by an extended access right. The ObjectType member of an ACE can contain a GUID that identifies the extended right. If ObjectType does not contain a GUID, the ACE controls the right to perform all extended right operations associated with the object.

Remarks

To assign access rights to an object, set the AccessMask field of an access-control entry (ACE) to a combination of the constants defined in this enumeration. In addition to the AccessMask field, an ACE can have other fields, including ACEType, ACEFlags, ObjectType, InheritedObjectType, Flags, and Trustee. The IADsAccessControlEntry interface provides property methods to obtain and modify these fields.

The ObjectType field specifies a GUID that identifies the property set, property, extended right, or type of child object to which the ACE applies. The InheritedObjectType field specifies a GUID that identifies the type of child object that can inherit the ACE. The Trustee field identifies the security principal to whom the ACE allows or denies the specified access rights.

For more information about ACEType, ACEFlags, and Flags, see ADS_ACETYPE_ENUM, ADS_ACEFLAG_ENUM.

Note  Because VBScript cannot read data from a type library, VBScript applications do not recognize the symbolic constants as defined above. Instead, use the numerical constants to set the appropriate flags in your VBScript application. To use the symbolic constants as a good programming practice, write explicit declarations of such constants, as done here, in your VBScript applications.

 

The specific access rights granted by the four generic rights enumerations (ADS_RIGHT_GENERIC_xxx) is dependent on the specific ADSI service provider being accessed. For Active Directory, these generic rights are defined in the Ntdsapi.h header file as DS_GENERIC_READ, DS_GENERIC_WRITE, DS_GENERIC_EXECUTE, and DS_GENERIC_ALL. For more information about how to use the Access Right and Access Masks, see Access Control.

Requirements

Requirement	Value
Minimum supported client	Windows Vista
Minimum supported server	Windows Server 2008
Header	iads.h

See also

ADSI Enumerations

ADS_ACETYPE_ENUM

Access Control

Access Rights and Access Masks

Directory Services Access Rights

IADsAccessControlEntry

IADsAccessControlEntry.AccessMask