This documentation is archived and is not being maintained.

AccessControlEntry Class

Specifies access rights for a trustee (user, group, or computer) to perform application-specific implementations of common tasks.

Namespace:  System.Messaging
Assembly:  System.Messaging (in System.Messaging.dll)

public class AccessControlEntry

The AccessControlEntry type exposes the following members.

Public methodAccessControlEntry()Initializes a new instance of the AccessControlEntry class that specifies neither a trustee nor set of rights to apply.
Public methodAccessControlEntry(Trustee)Initializes a new instance of the AccessControlEntry class that specifies a trustee to which rights are granted or denied.
Public methodAccessControlEntry(Trustee, GenericAccessRights, StandardAccessRights, AccessControlEntryType)Initializes a new instance of the AccessControlEntry class that specifies a trustee, rights to assign, and whether to grant or deny these rights.

Protected propertyCustomAccessRightsGets or sets custom access rights.
Public propertyEntryTypeGets or sets a value that indicates how the access rights apply to the trustee.
Public propertyGenericAccessRightsGets or sets a set of common access rights that map to both standard and object-specific access rights for reading, writing, and executing.
Public propertyStandardAccessRightsGets or sets a set of standard access rights that correspond to operations common to most types of securable objects.
Public propertyTrusteeGets or sets the user, group, domain, or alias to which you are assigning access rights.

Public methodEquals(Object)Determines whether the specified Object is equal to the current Object. (Inherited from Object.)
Protected methodFinalizeAllows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.)
Public methodGetHashCodeServes as a hash function for a particular type. (Inherited from Object.)
Public methodGetTypeGets the Type of the current instance. (Inherited from Object.)
Protected methodMemberwiseCloneCreates a shallow copy of the current Object. (Inherited from Object.)
Public methodToStringReturns a string that represents the current object. (Inherited from Object.)

Many applications have similar operations to which a trustee can be assigned rights, for example, reading, writing, and deleting objects. When you assign rights for these general operations, the application interprets them in a way specific to that application. For example, Message Queuing interprets the reading operation as receiving or peeking messages from a queue. The AccessControlEntry class provides access to these common rights.

When working with access control entries, you specify a trustee to which you are assigning the rights. You must set at least one of the GenericAccessRights, StandardAccessRights, or CustomAccessRights properties to indicate which rights to assign to the trustee. You can set the EntryType property to specify whether the rights you indicate should be granted or denied. The default entry type is to allow rights.

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.