ISoapReader (Windows CE 5.0)

Send Feedback

This interface, implemented by the SoapReader object, reads SOAP messages. The methods in this interface read the SOAP message and parse the message into a DOM. You can then retrieve the individual elements from the DOM.

The Calc sample application uses the ISoapReader interface. For more information, see SOAP Samples.

Various SoapReader properties make it easy to extract information out of the SOAP message without having to know the message's structure.

Note   While you can also retrieve information from a SOAP message using the Microsoft® XML Parser (MSXML) DOM API, the SoapReader properties make it easier to do the same thing.

The following tables show the methods and properties supported by ISoapReader interface.

Method Description
load This method loads an XML document from a file, stream, or a URL.
loadXML This method loads an XML document string provided as input.
Property Description
Body This property returns the <Body> element of a SOAP message.
BodyEntries This property returns a collection of entries in the <Body> element of a SOAP message.
BodyEntry This property returns the first entry in the <Body> element of a SOAP message that matches the given local name and namespace URI.
DOM This property provides a reference to the DOM document.
Envelope This property returns the <Envelope> element in a SOAP message (thus, the entire SOAP message).
Fault This property returns the <Fault> element in a SOAP message.
faultactor This property returns the <faultactor> element of the <Fault> element in the SOAP message.
faultcode This property returns the <faultcode> element of the <Fault> element in the SOAP message.
FaultDetail This property returns the <detail> element of the <Fault> element in the SOAP message.
faultstring This property returns the <faultstring> element of the <Fault> element in the SOAP message.
Header This property returns the <Header> element in a SOAP message.
HeaderEntries This property returns a collection of entries in the <Header> element of a SOAP message.
HeaderEntry This property returns the first entry in the <Header> element of a SOAP message that matches the given local name and namespace URI.
MustUnderstandHeaderEntries This property returns all entries from the <Header> element in a SOAP message that have a mustUnderstand attribute equal to 1.
RPCParameter This property returns the first child element of the first entry within the <Body> element of a SOAP that matches the given local name and namespace URI.
RPCResult This property returns the first child element of the first entry in the <Body> element of a SOAP message.
RPCStruct This property returns the first entry in the <Body> element of a SOAP message.
soapAction This property returns the "SOAPAction" HTTP header, if the input was a request object.

Requirements

OS Versions: Windows CE .NET 4.0 and later.
Header: Mssoap.h.
Link Library: Uuid.lib.

See Also

SOAP Objects and Interfaces

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.