3.1.4.6 GetFolder

The GetFolder operation gets folders, Calendar folders, Contacts folders, Tasks folders, and search folders.

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

 <wsdl:operation name="GetFolder">
     <wsdl:input message="tns:GetFolderSoapIn" />
     <wsdl:output message="tns:GetFolderSoapOut" />
 </wsdl:operation>

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

 <wsdl:operation name="GetFolder">
     <soap:operation soapAction="http://schemas.microsoft.com/exchange/services/2006/messages/GetFolder" />
     <wsdl:input>
         <soap:header message="tns:GetFolderSoapIn" part="Impersonation" use="literal"/>
         <soap:header message="tns:GetFolderSoapIn" part="MailboxCulture" use="literal"/>
         <soap:header message="tns:GetFolderSoapIn" part="RequestVersion" use="literal"/>
         <soap:header message="tns:GetFolderSoapIn" part="TimeZoneContext" use="literal"/>
         <soap:body parts="request" use="literal" />
     </wsdl:input>
     <wsdl:output>
         <soap:body parts="GetFolderResult" use="literal" />
         <soap:header message="tns:GetFolderSoapOut" part="ServerVersion" use="literal"/>
     </wsdl:output>
 </wsdl:operation>

The protocol client sends a GetFolderSoapIn request WSDL message, and the protocol server responds with a GetFolderSoapOut response WSDL message.

A successful GetFolder operation request returns a GetFolderResponse element with the ResponseClass attribute of the GetFolderResponseMessage element set to "Success" and the ResponseCode element of the GetFolderResponse element set to "NoError".

An unsuccessful GetFolder operation request returns a GetFolderResponse element with the ResponseClass attribute of the GetFolderResponseMessage element set to "Error". The ResponseCode element of the GetFolderResponseMessage element is set to a value of the ResponseCodeType simple type, as specified in [MS-OXWSCDATA] section 2.2.5.24.