Administering an Encyclopedia volume : Administering security and authentication operations : Getting an access control list : Requesting a file or folder’s ACL
 
Requesting a file or folder’s ACL
To retrieve the access rights that apply to a given file or folder, use GetFileACL. Specify the item using its full path.
For a file, you can include a version number, using the format shown in the following example:
<SOAP-ENV:Body>
<GetFileACL>
<FileName>/Grants and Deeds/Brisbane County Deeds.rptdesign; 3</FileName>
</GetFileACL>
</SOAP-ENV:Body>
The response returns the privileges for each security role or user that can access the file. The response also includes a TotalCount of users and security roles that can access the file. By default, TotalCount returns 500 records at a time. This limit is configurable. If the list is longer than the limit, the response also includes a FetchHandle mechanism to retrieve the balance of the list.
<SOAP-ENV:Body>
<GetFileACLResponse>
<ACL>
<Permission>
<RoleName>Administrator</RoleName>
<RoleId>141</RoleId>
<AccessRight>VSRWEDG</AccessRight>
</Permission>
<Permission>
<RoleName>Visitor</RoleName>
<RoleId>90</RoleId>
<AccessRight>V</AccessRight>
</Permission>
</ACL>
<TotalCount>2</TotalCount>
</GetFileACLResponse>
</SOAP-ENV:Body>