RolePermissions Property
An integer representing the permissions for a new role definition.
Syntax
spadmin.getRolePermissions(index, [callback]) spadmin.setRolePermissions(index, rolePermissions, [callback])
Default Value
0
Callback
The 'callback' parameter specifies a function which will be called when the operation completes (or an error is encountered). If the 'callback' parameter is not specified, then the method will block and will not return until the operation completes (or an error is encountered).
The callback for the getRolePermissions([callback]) method is defined as:
function(err, data){ }
'err' is the error that occurred. If there was no error, then 'err' is 'null'.
'data' is the value returned by the method.
The callback for the setRolePermissions([callback]) method is defined as:
function(err){ }
'err' is the error that occurred. If there was no error, then 'err' is 'null'.
'err' has 2 properties which hold detailed information:
err.code err.message
Remarks
An integer representing the permissions for a new role definition. This mask may contain multiple permissions as defined below:
Value | Name | Meaning |
0x00000000 | EmptyMask | This means the user has no permissions on the site. |
-1 | FullMask | Full permissions on the site. |
0x00000001 | ViewListItems | Allows user to view items in lists, documents in document libraries, and Web discussion comments. |
0x00000002 | AddListItems | Ability to add items to lists, documents to document libraries, and Web discussion comments. |
0x00000004 | EditListItems | Allows user to edit items in lists, edit documents in document libraries, edit Web discussion comments, and customize Web Part Pages in document libraries. |
0x00000008 | DeleteListItems | Delete items from lists, documents from document libraries, and Web discussion comments in documents. |
0x00000100 | CancelCheckout | Allows user to check in a document without saving the existing changes. |
0x00000200 | ManagePersonalViews | The ability to create, change, and delete personal views of lists. |
0x00000800 | ManageLists | Allows user to add/remove columns in a list, add/remove public views of a list, and create or delete lists. |
0x00010000 | OpenWeb | The ability to open a site, list, or folder. |
0x00020000 | ViewPages | Allows user to view the pages of a site. |
0x00040000 | AddAndCustomizePages | Add, change, or delete Web Part or HTML pages, and edit the site using a SharePoint-compatible editor. |
0x00080000 | ApplyThemeAndBorder | Applies a theme or border to the entire site. |
0x00100000 | ApplyStyleSheets | Ability to apply a style sheet to a site. |
0x00200000 | ViewUsageData | View site usage reports. |
0x00400000 | CreateSSCSite | Ability to create a site using Self-Service Site Creation. |
0x00800000 | ManageSubwebs | Allows user to create subsites including team sites, Meeting Workspace sites, and Document Workspace sites. |
0x01000000 | CreatePersonalGroups | Allows user to create groups that can be used anywhere within the site. |
0x02000000 | ManageRoles | Ability to create, change, and delete groups, including adding users to the groups and specifying the groups' rights. |
0x04000000 | BrowseDirectories | Browse files and folders in a site. |
0x08000000 | BrowseUserInfo | Allows user to browse user information of the site. |
0x10000000 | AddDelPrivateWebParts | Add/remove personal Web Parts on a Web Part. |
0x20000000 | UpdatePersonalWebParts | Ability to update Web Parts to contain personalized information. |
0x40000000 | ManageWeb | Manage a site including all permissions to perform any administration tasks for the site. |
The size of the array is controlled by the RoleCount property.
This property is not available at design time.
Data Type
Long64