IStreamConcatenate interface (imapi2.h)

Use this interface to combine several data streams into a single stream.

To create an instance of this interface, call the CoCreateInstance function. Use__uuidof(MsftStreamConcatenate) for the class identifier and __uuidof(IStreamConcatenate) for the interface identifier.

Inheritance

The IStreamConcatenate interface inherits from IStream. IStreamConcatenate also has these types of members:

Methods

The IStreamConcatenate interface has these methods.

IStreamConcatenate::Append Appends a stream to this stream.
IStreamConcatenate::Append2 Appends an array of streams to this stream.
IStreamConcatenate::Initialize Initializes this stream from two input streams.
IStreamConcatenate::Initialize2 Initializes this stream from an array of input streams.

Remarks

To create the MsftStreamConcatenate object in a script, use IMAPI2.MsftStreamConcatenate as the program identifier when calling CreateObject.

When using this interface, the following scenarios will result in undefined behaviors, and should be avoided:

• Each partial stream composing the MsftStreamConcatenate object is actually the same stream.
• Any of the concatenated streams are modified (read from, written to, or seeked on) outside of IMAPI.

Requirements

Requirement	Value
Minimum supported client	Windows Vista, Windows XP with SP2 [desktop apps only]
Minimum supported server	Windows Server 2003 [desktop apps only]
Target Platform	Windows
Header	imapi2.h

See also

IStreamInterleave

IStreamPseudoRandomBased