IHeaderHandler (Windows Embedded CE 6.0)

1/6/2010

This interface provides the methods necessary to create and access content contained in a SOAP header.

SOAP messages can contain zero or more headers, as well a body. In the Windows Embedded CE SOAP Toolkit, you can create and access headers on both the client and server.

• To use headers on the client side, you must provide a COM class that implements the IHeaderHandler interface and make the HeaderHandler property of the SoapClient object (accessed using the ISoapClient interface) reference an instance of this class.
• To use headers on the server side, you must provide a COM class that implements the IHeaderHandler interface and identify the class in the Web Services Meta Language (WSML) file for the service. The WSML file uses a <using> element to define a header handler object. This <using> element is associated with a particular <service>, <port>, or <operation> element.

The following table shows the methods supported by the IHeaderHandler interface.

Method	Description
willWriteHeaders Method	This method indicates if a header will be written.
writeHeaders Method	This method writes a header.
readHeader Method	This method reads a header.

Requirements

Header	mssoap.h
Library	uuid.lib
Windows Embedded CE	Windows CE .NET 4.0 and later

See Also

Reference

SOAP Objects and Interfaces

Concepts

Handling SOAP Headers