ISoapTypeMapper
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 provides the methods necessary for custom type mapper objects to handle complex types in a SOAP message.
Applications that send and receive complex types in SOAP messages may create a custom type mapper class that implements the ISoapTypeMapper interface. A complex type is as any type, other than an array, represented in a SOAP message as an XML element with child elements. For example, the Addr complex type may appear in a SOAP message as follows.
<Address>
<Street>...</State>
<City>...</City>
<State>...</State>
<Zip>...</Zip>
</Address>
The SoapClient and SoapServer objects (accessed using the ISoapClient and ISoapServer interfaces) use the custom type mapper objects to serialize and deserialize a specific complex type.
Note
The ISoapTypeMapper interface is derived from IDispatch.
The following tables show the methods supported by the ISoapTypeMapper interface.
| Method | Description |
|---|---|
This method initializes the type mapper object. |
|
This method converts (deserializes) an XML node in an incoming SOAP message into the complex type. |
|
This method returns the variant data type that is expected by the write method and will be returned by the read method. |
|
This method converts (serializes) a complex type into XML in an outgoing SOAP message. |
Remarks
For an example, see Handling Complex Types. In this application, the client and server send SOAP messages containing the Addr complex type. Also, the AddrMapper class implements the ISoapTypeMapper interface.
Requirements
| Header | mssoap.h |
| Library | uuid.lib |
| Windows Embedded CE | Windows CE .NET 4.0 and later |