Share via

3.1.4.1 AddGroup

  • Article

The AddGroup operation is used to add a group with the specified information.

 <wsdl:operation name="AddGroup">
     <wsdl:input message="tns:AddGroupSoapIn" />
     <wsdl:output message="tns:AddGroupSoapOut" />
 </wsdl:operation>

The protocol client sends an AddGroupSoapIn request message (section 3.1.4.1.1.1), and the protocol server responds with an AddGroupSoapOut response message (section 3.1.4.1.1.2), in the following sequence:

  1. If the value specified in the element ownerType is "group" and no group with the name specified in the element ownerIdentifier exists in the current site collection, the server MUST return a SOAP fault with error code 0x80131600.

  2. If the value specified in ownerType is "user" and the user with the name specified in ownerIdentifier does not exist in the current site collection, the server MUST return a SOAP fault with error code 0x80131600.

  3. If the user with the name specified in the element defaultUserLoginName does not exist in the current site collection, the server MUST return a SOAP fault with error code 0x80131600.

  4. If the value specified in ownerType is "group" and the group with the name specified in ownerIdentifier exists on the current site collection, but the group is a domain group, the server MUST return a SOAP fault with error code 0x80131600.

  5. If the group name contains any special characters (" / \ [ ] : | < > + = ; , ? * ' @), the server MUST return a SOAP fault with the error code 0x8102004f.

  6. If a group with the name specified in the element groupName already exists on the current site collection, the server MUST return a SOAP fault with error code 0x81020043.

  7. Otherwise, the server MUST add the group with an identifier and MUST respond with an AddGroupSoapOut response message.