ISoapReader
Other versions of this page are also available for the following:
.gif "A hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
8/28/2008
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 |
|---|---|
This method loads an XML document from a file, stream, or a URL. |
|
This method loads an XML document string provided as input. |
| Property | Description |
|---|---|
This property returns the <Body> element of a SOAP message. |
|
This property returns a collection of entries in the <Body> element of a SOAP message. |
|
This property returns the first entry in the <Body> element of a SOAP message that matches the given local name and namespace URI. |
|
This property provides a reference to the DOM document. |
|
This property returns the <Envelope> element in a SOAP message (thus, the entire SOAP message). |
|
This property returns the <Fault> element in a SOAP message. |
|
This property returns the <faultactor> element of the <Fault> element in the SOAP message. |
|
This property returns the <faultcode> element of the <Fault> element in the SOAP message. |
|
This property returns the <detail> element of the <Fault> element in the SOAP message. |
|
This property returns the <faultstring> element of the <Fault> element in the SOAP message. |
|
This property returns the <Header> element in a SOAP message. |
|
This property returns a collection of entries in the <Header> element of a SOAP message. |
|
This property returns the first entry in the <Header> element of a SOAP message that matches the given local name and namespace URI. |
|
This property returns all entries from the <Header> element in a SOAP message that have a mustUnderstand attribute equal to 1. |
|
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. |
|
This property returns the first child element of the first entry in the <Body> element of a SOAP message. |
|
This property returns the first entry in the <Body> element of a SOAP message. |
|
This property returns the "SOAPAction" HTTP header, if the input was a request object. |
Requirements
| Header | mssoap.h |
| Library | uuid.lib |
| Windows Embedded CE | Windows CE .NET 4.0 and later |