Do not use. Manipulates the rows in a message header or a body header.

Remarks

IMimeHeaderTable allows the client to treat each line in a header as a row where each row consists of a header name and header data.

A header can sometimes contain the same row multiple times. For example, most messages have multiple "Received" headers. This interface is the best way of managing duplicate rows in a header.

A client uses the IMimePropertySet interface as the primary way to manipulate a message header. IMimeHeaderTable gives the client more low-level control over the rows in a header than IMimePropertySet.

There are multiple ways in which a client can obtain an IMimeHeaderTable object:

• By calling CoCreateInstance (IMimeHeaderTable does not support aggregation), for example:

  CoCreateInstance(CLSID_IMimeHeaderTable, NULL, CLSCTX_INPROC_SERVER, IID_IMimeHeaderTable, (LPVOID*)&pHeaderTable);

• By using an IMimePropertySet object, for example:

  IMimePropertySet::BindToObject(hBody, IID_IMimeHeaderTable, (LPVOID*)&pHeaderTable);

• By using an IMimeBody object, for example:

  IMimeBody::BindToObject(IID_IMimeHeaderTable, (LPVOID*)&pHeaderTable);

• By using an IMimeAddressTable object, for example:

  IMimeAddressTable::BindToObject(IID_IMimeHeaderTable, (LPVOID*)&pHeaderTable);

Interface Information

Stock Implementation	inetcomm.dll version 6.0 or later
Custom Implementation	No
Inherits from	IPersistStream
Header and IDL files	mimeole.h, mimeole.idl
Minimum availability	Outlook Express 6.0
Minimum operating systems	Windows XP