1. Home / Web Services API Version 8.x / GetAccessListHistory

GetAccessListHistory

Returns the historical records of the access list for a document or a folder in the specified path.

Syntax

Visual Basic (declaration) 
Public Function GetAccessListHistory( _ 
	ByVal AuthenticationTicket as String, _ 
	ByVal Path as String) as XmlNode

C# (declaration) 
public XmlNode GetAccessListHistory( 
	string AuthenticationTicket,
	string Path)

Parameters

AuthenticationTicket
    string infoRouter ticket
Path
    string A folder or a document path

Return Value

returns xml fragment.
if success = "true", the function returns the access list xml fragment.
if success = "false", the error attribute returns the error description.

<response success="true" error="">
  <AccessList DateApplied="2007-11-03 15:23:09" AppliedBy="System Administrator" InheritedSecurity="false">
    <UserGroup DomainName="" GroupName="Accountants" Right="2" Description="(Read)" />
    <User DomainName="" UserName="adamb" Right="0" Description="(No Access)" />
    <User DomainName="" UserName="diannaf" Right="6" Description="(Full Control)" />
    <User DomainName="" UserName="henryb" Right="6" Description="(Full Control)" />
  </AccessList>
  <AccessList DateApplied="2007-09-13 10:11:59" AppliedBy="System Administrator" InheritedSecurity="false">
    <UserGroup DomainName="" GroupName="Accountants" Right="2" Description="(Read)" />
    <User DomainName="" UserName="adamb" Right="0" Description="(No Access)" />
    <User DomainName="" UserName="diannaf" Right="6" Description="(Full Control)" />
    <User DomainName="" UserName="henryb" Right="6" Description="(Full Control)" />
  </AccessList>
  <AccessList DateApplied="2007-06-08 11:03:39" AppliedBy="System Administrator" InheritedSecurity="false">
    <UserGroup DomainName="" GroupName="Accountants" Right="2" Description="(Read)" />
    <UserGroup DomainName="" GroupName="Auditors" Right="2" Description="(Read)" />
    <User DomainName="" UserName="diannaf" Right="6" Description="(Full Control)" />
  </AccessList>
</response>

Remarks

The caller must have full control on the document or folder to get the access list.
The audit log option for security must be enabled.

See Also