Permissions.UpdatePermission Method

Modifies site-level permissions for the specified site group, or modifies permissions to the list for the specified user, site group, or cross-site group.

Namespace:  [Permissions Web service]
Web service reference: http://Site/_vti_bin/Permissions.asmx

Syntax

'Declaration
<SoapDocumentMethodAttribute("https://schemas.microsoft.com/sharepoint/soap/directory/UpdatePermission", RequestNamespace := "https://schemas.microsoft.com/sharepoint/soap/directory/",  _
    ResponseNamespace := "https://schemas.microsoft.com/sharepoint/soap/directory/",  _
    Use := SoapBindingUse.Literal, ParameterStyle := SoapParameterStyle.Wrapped)> _
Public Sub UpdatePermission ( _
    objectName As String, _
    objectType As String, _
    permissionIdentifier As String, _
    permissionType As String, _
    permissionMask As Integer _
)
'Usage
Dim instance As Permissions
Dim objectName As String
Dim objectType As String
Dim permissionIdentifier As String
Dim permissionType As String
Dim permissionMask As Integer

instance.UpdatePermission(objectName, _
    objectType, permissionIdentifier, _
    permissionType, permissionMask)

[SoapDocumentMethodAttribute("https://schemas.microsoft.com/sharepoint/soap/directory/UpdatePermission", RequestNamespace = "https://schemas.microsoft.com/sharepoint/soap/directory/", 
    ResponseNamespace = "https://schemas.microsoft.com/sharepoint/soap/directory/", 
    Use = SoapBindingUse.Literal, ParameterStyle = SoapParameterStyle.Wrapped)]
public void UpdatePermission(
    string objectName,
    string objectType,
    string permissionIdentifier,
    string permissionType,
    int permissionMask
)

Parameters

• objectName
  Type: System.String

  A string that contains the name of the list or site.

• objectType
  Type: System.String

  A string that specifies either List or Web.

• permissionIdentifier
  Type: System.String

  A string that contains the name of the site group, the name of the cross-site group, or the user name (DOMAIN\User_Alias) of the user to whom the permission applies.

• permissionType
  Type: System.String

  A string that specifies user, group (cross-site group), or role (site group). The user or cross-site group must be valid, and the site group must already exist on the site.

• permissionMask
  Type: System.Int32

  A 32-bit integer that specifies the new permission mask (for example, 134284064). The GetPermissionCollection can be used to return the permissions for the site or list.

Remarks

To access the Permissions service and its methods, set a Web reference to https://Server_Name/[sites/][Site_Name/]_vti_bin/Permissions.asmx.

Examples

The following code example modifies the permissions for a site group on the current site.

Dim permService As New Web_Reference_Folder_Name.Permissions()
permService.Credentials = System.Net.CredentialCache.DefaultCredentials

permService.UpdatePermission("Site_Name", "Web", "Site_Group", "role", 134283265)

Web_Reference_Folder_Name.Permissions permService = new Web_Reference_Folder_Name.Permissions();
permService.Credentials= System.Net.CredentialCache.DefaultCredentials;

permService.UpdatePermission("Site_Name", "Web", "Site_Group", "role", 134283265);

See Also

Reference

Permissions Class

Permissions Members

Permissions Web Service