Share via


IHeaderHandler

Other versions of this page are also available for the following:

Windows Mobile Not SupportedWindows Embedded CE Supported

8/28/2008

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