Purpose:
The DXAccessControlDL class defines access control functions provided in Content Manager.
Methods:
init(LPDISPATCH ds);
Must be called following the creation of a DXAccessControlDL object.
BSTR type();
BSTR getName();
addAccessControlList(LPCTSTR acl_name, LPCTSTR description, LPDISPATCH access_data);
Adds an access control list into the system. acl_name specifies the name of access control list. description provides the textual information of the access control list. access_data specifies the access data entries of the access control list. Each access data entry is an object of DXAccessDataDL, which is defined below.
updateAccessControlList(LPCTSTR acl_name, LPCTSTR description, LPDISPATCH access_data);
Updates an access control list in the system. acl_name specifies the name of access control list. description provides the textual information of the access control list. access_data specifies the access data entries of the access control list. Each access data entry is an object of DXAccessDataDL, which is defined below.
deleteAccessControlList(LPCTSTR acl_name);
Deletes an access control list in the system. acl_name specifies the name of access control list.
String getItemACL(LPCTSTR itemID);
Returns the name of access control list of the specified item ID.
setItemACL(LPCTSTR itemID, LPCTSTR acl_name);
Associates an access control list with the specified item ID.
LPDISPATCH listAccessControlLists();
Returns a collection of DXAccessControlListDL objects defined in the system.
LPDISPATCH listAccessControlList(LPCTSTR acl_name);
Returns a DXAccessControlListDL object with the specified name.
LPDISPATCH listPrivileges();
Returns a collection of string objects containing the name of privilege sets defined in the system.
BSTR listPrivilege(LPCTSTR user_name);
LPDISPATCH listUsers(); LPDISPATCH listUsers(LPCTSTR group_name);
The first form returns a collection of string objects containing the name of users defined in the system. The second form returns a collection of string objects containing the name of users defined in a group.
LPDISPATCH listGroups(); LPDISPATCH listGroups(LPCTSTR user_name);
The first form returns a collection of string objects containing the name of groups defined in the system. The second form returns a collection of string objects containing the name of groups that the specified user is part of.
BSTR listPrivilegeString(LPCTSTR privilege_name);
Returns TRUE if the specified authority is granted in the privilege string.
BOOL isAuthorized(LPCTSTR privilege_string, long authority);
Returns TRUE if the specified authority is granted in the privilege string.
BOOL isAccessControlList(LPCTSTR acl_name);
Returns TRUE if the specified name is a valid access control list.
BOOL isPrivilege(LPCTSTR privilege_name);
BOOL isUser(LPCTSTR user_name);
BOOL isGroup(LPCTSTR group_name);
Returns TRUE if the specified name is a valid group.
(c) Copyright International Business Machines Corporation 1996, 2002. IBM Corp. All rights reserved.