SharePoint2007Provider::CreateSubSite

  • Article

This procedure creates a subsite of the specified parent SharePoint site.

Arguments

Input Arguments Required Description

<target>

Yes

The URL of the Windows SharePoint Services administration site.

<siteGUID>

Yes

The globally unique identifier (GUID) of site collection.

<parentSubSiteGUID>

Yes

The GUID of parent sub site which the new sub site is created under.

<siteName>

Yes

The name of the sub site.

<title>

Yes

The title of the sub site.

<description>

Yes

The description for the sub site.

<lcid>

Yes

The site's locale ID (system default culture if not supplied). Search MSDN for "Locale Code Table" for a list of codes.

<inheritParentPermissions>

Yes

A Boolean value that indicates if the sub site should inherit its permissions from its parent site.

<convertExistingFolder>

Yes

A Boolean value that specifies whether to convert an existing folder of the same name to a SharePoint site. The method will fail if convertExistingFolder is set to false and a URL path with the specified site name already exists.

<webTemplate>

No

Optional input. The name of the site template to use when creating the site.
Output Arguments Description

<site>

The URL of the created sub site.

<subSiteGUID>

The GUID of the created sub site.

Remarks

No remarks.

Sample Code

Example XML Request

<request> 
   <procedure> 
      <execute namespace="SharePoint2007Provider" procedure="CreateSubSite" impersonate="1"> 
         <executeData> 
            <target>https://WSSFE:8080</target> 
            <siteGUID>ac5395a7-595f-44b9-aa42-4d24bb7f85cd</siteGUID> 
            <parentSubSiteGUID>6b13195a-4a43-4678-9cfb-5b36d16821fb</parentSubSiteGUID> 
            <siteName>SPNSSubSite</siteName> 
            <title>Test Sub Site</title> 
            <description>Sub Site Created</description> 
            <lcid>1033</lcid> 
            <inheritParentPermissions>true</inheritParentPermissions> 
            <convertExistingFolder>false</convertExistingFolder> 
            <webTemplate>sts#0</webTemplate> 
         </executeData> 
         <after source="executeData" destination="data" mode="merge" /> 
      </execute> 
   </procedure> 
</request>

Example XML Response

<response> 
   <data> 
      <site>https://wssfe:8888/sites/SPNSSite/SPNSSubSite</site> 
      <subSiteGUID>0233616a-caab-4a22-bd7f-55d2b3e986d2</subSiteGUID> 
   </data> 
</response>

Applies To

SharePoint 2007 Provider for:

  • Hosted Messaging and Collaboration version 4.5

  • Hosted Messaging and Collaboration version 4.0

See also

Tasks

SharePoint2007Provider::DeleteSubSite