SharePoint2007Provider::UpdateRoleInfo

  • Article

This procedure of the Users and Groups service updates information for the specified role.

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 subsite.

<roleName>

Yes

A string that contains the name of the role.

<newRolepName>

Yes

A string that contains the new name of the role.

<description>

Yes

A string that contains a description of the role.

<basePermissions>

Yes

A comma delineated list of SPBasePermission values.

Remarks

The underlying Windows SharePoint Services API does not provide a mechanism for updating any subset of these parameters, so all of them must be supplied. This method supports rollback.

Sample Code

Example XML Request

<request> 
   <procedure> 
      <execute namespace="SharePoint2007Provider" procedure="UpdateRoleInfo" impersonate="1"> 
         <executeData> 
            <target>https://WSSFE:8080</target> 
            <siteGUID>e2c3aef9-5a4d-46ef-950f-d4f6ad4beb6b</siteGUID> 
            <subSiteGUID>7d25e3e8-7d19-42cb-85c4-5d03818c0723</subSiteGUID> 
            <roleName>SPNSTestRole</roleName> 
            <newRoleName>SPNSTestRoleNew</newRoleName> 
            <description>UpdateRoleInfo Test.</description> 
            <basePermissions>FullMask</basePermissions> 
         </executeData> 
      </execute> 
   </procedure> 
</request>

Applies To

SharePoint 2007 Provider for:

  • Hosted Messaging and Collaboration version 4.5

  • Hosted Messaging and Collaboration version 4.0

See also

Tasks

SharePoint2007Provider::GetRoleInfo