3.1.4.4 AddNewImContactToGroup

  • Article

The AddNewImContactToGroup WSDL operation adds a new contact (2) to an instant messaging group.

The following is the WSDL port type specification of the AddNewImContactToGroup WSDL operation.

 <wsdl:operation name="AddNewImContactToGroup" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/">
   <wsdl:input message="tns:AddNewImContactToGroupSoapIn"/>
   <wsdl:output message="tns:AddNewImContactToGroupSoapOut"/>
 </wsdl:operation>

The following is the WSDL binding specification of the AddNewImContactToGroup WSDL operation.

 <wsdl:operation name="AddNewImContactToGroup" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/">
   <soap:operation soapAction="http://schemas.microsoft.com/exchange/services/2006/messages/AddNewImContactToGroup" xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/"/>
   <wsdl:input>
     <soap:header message="tns:AddNewImContactToGroupSoapIn" part="Impersonation" use="literal" xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/"/>
     <soap:header message="tns:AddNewImContactToGroupSoapIn" part="MailboxCulture" use="literal" xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/"/>
     <soap:header message="tns:AddNewImContactToGroupSoapIn" part="RequestVersion" use="literal" xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/"/>
     <soap:body use="literal" parts="request" xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/"/>
   </wsdl:input>
   <wsdl:output>
     <soap:body use="literal" parts="AddNewImContactToGroupResult" xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/"/>
     <soap:header message="tns:AddNewImContactToGroupSoapOut" part="ServerVersion" use="literal" xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/"/>
   </wsdl:output>
 </wsdl:operation>

If the group contains more than the maximum 1000 contacts (2), this operation fails and ErrorImContactLimitReached (as specified in [MS-OXWSCDATA] section 2.2.5.24) will be returned. If a contact (3) already exists that has the same instant messaging address, this operation does nothing.

The protocol client sends an AddNewImContactToGroupSoapIn request WSDL message and the protocol server responds with an AddNewImContactToGroupSoapOut response WSDL message.