Click or drag to resize

IAclHierarchyItemAsyncSetAclAsync Method

IT Hit WebDAV Classes Reference
Sets list of access control entries (ACEs), which define what principals are to get what privileges for this resource.

Namespace:  ITHit.WebDAV.Server.Acl
Assembly:  ITHit.WebDAV.Server (in ITHit.WebDAV.Server.dll) Version: 11.3.10719
Syntax
Copy
Task SetAclAsync(
	IList<WriteAce> aces
)

Task SetAclAsync(
	IList<WriteAce> aces
)

Parameters

aces
Type: System.Collections.GenericIListWriteAce
Identifies whether to search by owner or group.

Return Value

Type: Task
.
Exceptions
ExceptionCondition
LockedExceptionThe item is locked and no or invalid lock token was provided.
NeedPrivilegesExceptionNot enough permissions.
DavExceptionIn case of other errors. It is possible for status code to be CONFLICT and error description one of values in SetAclErrorDetails class.
Remarks
Two common operations are to add or remove an ACE from an existing access control list. To accomplish this, a client uses the PROPFIND method to retrieve the value of the DAV:acl property, then parses the returned access control list to remove all inherited and protected ACEs (these ACEs are tagged with the DAV:inherited and DAV:protected XML elements). In the remaining set of non-inherited, non-protected ACEs, the client can add or remove one or more ACEs before submitting the final ACE set in the request body of the ACL method. It is possible that the ACEs visible to the current user in the DAV:acl property may only be a portion of the complete set of ACEs on that resource. If this is the case, an ACL request only modifies the set of ACEs visible to the current user, and does not affect any non-visible ACE.
See Also