Export (0) Print
Expand All

3.1.4.3 AddList

SharePoint

The AddList operation is used to add a new list to the site that is based on the list template that has an identification matching the specified templateID.

<wsdl:operation name="AddList">
    <wsdl:input message="AddListSoapIn" />
    <wsdl:output message="AddListSoapOut" />
</wsdl:operation>

The protocol client sends an AddListSoapIn request message (section 3.1.4.3.1.1) and the server responds with an AddListSoapOut response message (section 3.1.4.3.1.2), as follows:

  1. If the templateID provided is less than zero, the protocol server MUST return a SOAP fault. There is no error code for this fault. This indicates that the list template is invalid.

  2. If the templateID provided is not one of the known list template identifiers, or no templateID parameter is provided, the protocol server MUST return a SOAP fault with error code 0x8102007b. This indicates that the list template is invalid.

  3. If the templateID provided matches a known template, but a list based on that template already exists and the template is marked as unique, the protocol server MUST return a SOAP fault with error code 0x8102003c. This indicates that templateID provided is marked unique and that a list with the specified templateID already exists.

  4. If the feature identifier that corresponds with the provided templateID is not installed on the site, the protocol server MUST return a SOAP fault. This indicates that the feature for the provided templateID is not installed on the site.

  5. If the listName is already used by another list, the protocol server MUST return a SOAP fault with error code 0x81020012. This indicates that another list has the specified listName.

  6. Otherwise, a new list named listName MUST be created on the site by using the template with an identification matching the provided templateID. The list description MUST be the description passed in.

Show:
© 2014 Microsoft