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: WebSvcPermissions
Assembly: STSSOAP (in STSSOAP.dll)
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.StringA string that contains the name of the list or site.
objectType
Type: System.StringA string that specifies either List or Web.
permissionIdentifier
Type: System.StringA 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.StringA 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.Int32A 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);