Share via

3.1.4.3 GetCallInfo Operation

  • Article

The GetCallInfo operation returns information about a call. The GetCallInfo 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 for the operation.

   <wsdl:operation name="GetCallInfo">
     <wsdl:input message="tns:GetCallInfoSoapIn" />
     <wsdl:output message="tns:GetCallInfoSoapOut" />
   </wsdl:operation>

The following is the WSDL binding specification for the operation.

 <wsdl:operation name="GetCallInfo">
    <soap:operation soapAction="http://schemas.microsoft.com/exchange/services/2006/messages/GetCallInfo" 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 GetCallInfoResponse 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 is returned if the GetCallInfo operation specifies an incorrect phone call identifier in the CallId element, as specified in section 3.1.4.3.2.1. The following XML specifies the SOAP fault response that SHOULD<8> be returned if an invalid phone call identifier is provided as an argument to a GetCallInfo 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>
         <ExceptionType xmlns:m="http://schemas.microsoft.com/exchange/services/2006/messages">InvalidCallIdException</ExceptionType>
       </detail>
     </s:Fault>
   </s:Body>
 </s:Envelope>

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

The faultstring element SHOULD<10> have 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.