SharePoint2007Provider::AddUsersToRole

  • Article

This procedure adds one or more user accounts to the specified role. This call implements rollback.

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 the user to.

<users>

Yes

The data for each user, including:

  1. user/LoginName - The login name of the user.

  2. user/name - (Optional) The name of the user to add.

  3. user/email - (Optional) The E-mail address of the user.

  4. user/notes - (Optional) The notes for the user.

Remarks

This call does not currently create a user if it does not exist.

Sample Code

Example XML Request

<request> 
   <procedure> 
      <execute namespace="SharePoint2007Provider" procedure="AddUsersToRole" impersonate="1"> 
         <executeData> 
            <target>https://WSSFE:8080</target> 
            <siteGUID>2faab4e5-ff3c-4896-9b9b-2e8f8e8d3ed1</siteGUID> 
            <subSiteGUID>0b50f1e6-98c2-45fd-afa6-7053481e8a4a</subSiteGUID> 
            <roleName>SPNSTestRole</roleName> 
            <users> 
               <user loginName="Fabrikam\Administrator" email="Administrator@Fabrikam.Com" name="Administrator" notes="AddUsersToRole Test" /> 
            </users> 
         </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::RemoveUsersFromRole