3.1.4.1 ConvertId

  • Article

The ConvertId operation SHOULD<1> convert the item identifier supplied by the client into a different identifier format.

The following is the WS DL port type specification of the operation.

  
 <wsdl:operation name="ConvertId">
     <wsdl:input message="tns:ConvertIdSoapIn"/>
     <wsdl:output message="tns:ConvertIdSoapOut"/>
 </wsdl:operation>

The following is the WSDL binding specification of the operation.

 <wsdl:operation name="ConvertId">
    <soap:operation soapAction="http://schemas.microsoft.com/exchange/services/2006/messages/ConvertId" />
    <wsdl:input>
        <soap:header message="tns:ConvertIdSoapIn" part="Impersonation" use="literal"/>
        <soap:header message="tns:ConvertIdSoapIn" part="RequestVersion" use="literal"/>
        <soap:body parts="request" use="literal" />
    </wsdl:input>
    <wsdl:output>
        <soap:body parts="ConvertIdResult" use="literal" />
        <soap:header message="tns:ConvertIdSoapOut" part="ServerVersion" use="literal"/>
    </wsdl:output>
 </wsdl:operation>

Servers that implement this protocol SHOULD<2> give clients the option to implement the Impersonation SOAP header.