3.1.4.1 Disconnect Operation

  • Article

The Disconnect operation disconnects a call. The Disconnect operation uses the endpoint specified in [MS-OXDSCLI] section 2.2.4.1.1.2.6.47.

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

 <wsdl:operation name="Disconnect">
     <wsdl:input message="tns:DisconnectSoapIn" />
     <wsdl:output message="tns:DisconnectSoapOut" />
 </wsdl:operation>

The following is the WSDL binding specification of the operation.

 <wsdl:operation name="Disconnect">
    <soap:operation soapAction="http://schemas.microsoft.com/exchange/services/2006/messages/Disconnect" style="document"/>
    <wsdl:input>
       <soap:body use="literal"/>
    </wsdl:input>
    <wsdl:output>
       <soap:body use="literal"/>
    </wsdl:output>
 </wsdl:operation>

If the operation succeeds, a DisconnectResponse element is returned. If the operation fails, a SOAP fault response, as specified in [SOAP1.1], is returned that contains information about the failure. A SOAP fault MUST be returned if the Disconnect operation specifies an incorrect phone call identifier in the CallId element, as specified in section 3.1.4.1.2.1, or if this element is not specified. The following XML specifies the SOAP fault response that SHOULD<4> be returned if an invalid phone call identifier is provided as an argument to a Disconnect operation request.

 <?xml version="1.0" encoding="utf-8"?>
 <s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <s:Body>
     <s:Fault>
       <faultcode xmlns:a="http://schemas.microsoft.com/exchange/services/2006/errors">a:InvalidCallIdException</faultcode>
       <faultstring xml:lang="en-US">The call identifier isn't valid.</faultstring>
       <detail>
         <m:ExceptionType xmlns:m="http://schemas.microsoft.com/exchange/services/2006/messages">InvalidCallIdException</m:ExceptionType>
       </detail>
     </s:Fault>
   </s:Body>
 </s:Envelope>

The faultcode element SHOULD<5> contain a text value of "a:InvalidCallIdException" if an invalid phone call identifier is sent in the request.

The faultstring element SHOULD<6> contain a text value of "The call identifier isn't valid." if an invalid phone call identifier is sent in the request.

The contents of the SOAP fault detail element are specified by the ExceptionType element, as specified in section 2.2.3.1.