CanCreateDwsUrl Method

The CanCreateDwsUrl method of the Document Workspace service determines whether the user has sufficient rights to create a Document Workspace site with the proposed URL on the server.

Parameters

url  String. The proposed URL for the new Document Workspace site.

Return Value

String Returns the URL in the format <Result>{proposed URL}</Result> when successful.

Note  The URL may be modified as described in the following section.

Error Values

The following table shows errors that may be returned by the CanCreateDwsUrl method.

Error Code	Description
HTTP error code 401	The user does not have sufficient rights.

Remarks

The CanCreateDwsUrl method determines whether the user has sufficient rights to create a Document Workspace site with the proposed URL on the server. This method returns the suggested URL after replacing illegal characters, shortening the the proposed URL as necessary, and appending a numeric index if necessary to make the URL unique. For example, if the proposed URL My_New_Site already exists, the CanCreateDwsUrl method returns My_New_Site(1).

When the user does not have sufficient rights, the HTTP error response raises an exception.

Example

The following code example displays the suggested URL for the new Document Workspace site as returned by the CanCreateDwsUrl method.

Example

Helper Functions

The following sample helper functions are used in the code samples provided for each method of the Document Workspace service.

Requirements

Platforms: Microsoft Windows Server 2003

Web Reference: http://Server_Name/_vti_bin/Dws.asmx