IAclHierarchyItemSetAclAsync 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: 13.3.13068
SyntaxParameters
- aces
- Type: System.Collections.GenericIListWriteAce
Identifies whether to search by owner or group.
Return Value
Type: Task.
Exceptions| Exception | Condition |
|---|---|
| LockedException | The item is locked and no or invalid lock token was provided. |
| NeedPrivilegesException | Not enough permissions. |
| DavException | In 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