SharePoint2007Provider::AddRole

This procedure adds a role to the Windows SharePoint Services site. Rollback deletes the site group.

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.

<roleName>

Yes

The name of the role to add to the site.

<description>

Yes

The description of the new role.

<permissionMask>

Yes

A 32-bit integer specifying the rights of the new role.

Remarks

No remarks.

Sample Code

Example XML Request

<request> 
   <procedure> 
      <execute namespace="SharePoint2007Provider" procedure="AddRole" impersonate="1"> 
         <executeData> 
            <target>https://WSSFE:8080</target> 
            <siteGUID>b6033560-abea-410e-ae85-9bc6f2907b79</siteGUID> 
            <subSiteGUID>c1e1ce9c-751e-4e70-b6a5-d8fcce1a9a6d</subSiteGUID> 
            <roleName>SPNSTestRole</roleName> 
            <description>Role Created</description> 
            <permissionMask>1073741824</permissionMask> 
         </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::UpdateRoleInfo
SharePoint2007Provider::GetRoleInfo