IMimeHeaderTable interface

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

Members

The IMimeHeaderTable interface inherits from IPersistStream but does not have additional members.

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);

Requirements