SharePoint2007Provider::SetListPermissions

  • Article

This procedure adds, modifies, or removes permissions to the list for the specified collection of existing users, groups, and/or roles.

Arguments

Input Arguments Required Description

<target>

Yes

The URL of the Windows SharePoint Services administration site.

<siteGUID>

Yes

The globally unique identifier (GUID) of Windows SharePoint Services site collection.

<subSiteGUID>

Yes

The GUID of sub site.

<name >

Yes

A string that contains the name of the list.

<permissions>

Yes

The collection of permissions.

Remarks

  • This procedure supports rollback.

  • Permissions which do not correspond to standard Windows SharePoint Services permissions may provoke unpredictable errors from Windows SharePoint Services.

  • This method overwrites the existing permissions with the ones specified in the permissions node.

  • This method does not break permission inheritance automatically. To successfully set permissions on a list the list must first be set to not inherit permissions.

Sample Code

Example XML Request

<request> 
   <procedure> 
      <execute namespace="SharePoint2007Provider" procedure="SetListPermissions" impersonate="1"> 
         <executeData> 
            <target>https://WSSFE:8080</target> 
            <siteGUID>d454e032-7341-46cf-a4b3-badc61f2a5ea</siteGUID> 
            <subSiteGUID>9c05e9c5-812c-4162-90cd-2ef24862730e</subSiteGUID> 
            <name>Announcements</name> 
            <permissions> 
               <users> 
                  <user loginName="Fabrikam\Administrator" roleBindings="Administrator" /> 
               </users> 
               <groups> 
                  <group groupName="SPNSTestGroup" roleBindings="Administrator" /> 
               </groups> 
            </permissions> 
         </executeData> 
      </execute> 
   </procedure> 
</request>

Applies To

SharePoint 2007 Provider for:

  • Hosted Messaging and Collaboration version 4.5

  • Hosted Messaging and Collaboration version 4.0